finary-mcp

Un servidor deliberadamente de solo lectura Model Context Protocol para Finary, construido sobre el cliente no oficial finary-uapi.

[!WARNING] Este proyecto es independiente de Finary y no está respaldado, soportado o mantenido por Finary. Depende de endpoints privados y no documentados a través de finary-uapi; cualquiera de los dos proyectos puede fallar sin previo aviso. No es asesoramiento financiero, fiscal, legal o de inversión.

Modelo de seguridad

finary-mcp es intencionalmente un adaptador estrecho y de solo lectura:

• Solo expone consultas de perfil, organización, institución, cartera y transacciones.

• No tiene ninguna herramienta de inicio de sesión, importación de cuentas, creación, actualización, eliminación, transferencia, comercio o CLI genérica.

• Construye comandos de finary-uapi a partir de una lista blanca fija, sin shell.

• Los valores de filtro se validan antes de la ejecución.

• No devuelve stdout/stderr del upstream cuando una solicitud falla, porque un flujo de inicio de sesión del upstream puede imprimir material de sesión.

• Su directorio de estado es explícito (FINARY_MCP_STATE_DIR); no busca tokens en directorios de trabajo arbitrarios.

Esto reduce escrituras accidentales a través de MCP. No hace que una máquina sea segura si otro proceso puede leer tus archivos de sesión. Ejecuta el servidor solo para una cuenta y perfil en los que confíes.

Advertencia importante de autenticación

«Solo lectura» se refiere a los datos de cartera de Finary. finary-uapi actualiza su sesión de Clerk antes de las solicitudes y puede reescribir jwt.json; por lo tanto, el directorio de estado privado debe permanecer escribible por la cuenta de servicio local aunque ninguna herramienta MCP cambie los datos de Finary. El servidor nunca devuelve ese archivo, cookies o diagnósticos de procesos secundarios.

finary-uapi también trae fuzzywuzzy como dependencia transitiva GPL-2.0. Revisa el grafo de dependencias upstream y las implicaciones de licencia para tu distribución o despliegue previsto.

Related MCP server: C6 Bank MCP

Requisitos previos

• Python 3.10+.

• Una sesión local de Finary ya creada por finary-uapi.

• Un directorio privado que contenga tanto jwt.json como localCookiesMozilla.txt, con modo 0700 para el directorio y 0600 para los archivos.

El servidor no soporta Google OAuth por sí mismo. Sigue el proceso de autenticación soportado por finary-uapi para crear o renovar la sesión local. Nunca envíes una contraseña, código TOTP, JWT, exportación de cookies o archivo de sesión a un agente, repositorio, rastreador de problemas o chat.

Instalación

python -m venv .venv
. .venv/bin/activate
pip install finary-mcp

Para desarrollo desde un checkout:

pip install -e '.[dev]'
pytest -q

Configurar un host MCP

Configura FINARY_MCP_STATE_DIR al directorio que contiene tu sesión de Finary. Si finary-uapi está instalado en un entorno virtual separado, configura FINARY_UAPI_PYTHON al ejecutable de Python de ese entorno.

Ejemplo de configuración genérica stdio:

{
  "mcpServers": {
    "finary": {
      "command": "/path/to/finary-mcp/.venv/bin/finary-mcp",
      "env": {
        "FINARY_MCP_STATE_DIR": "/private/path/to/finary-state",
        "FINARY_UAPI_PYTHON": "/path/to/finary-uapi/.venv/bin/python"
      }
    }
  }
}

Usa rutas absolutas. El directorio de estado son datos privados y nunca debe ser confirmado. El .gitignore suministrado excluye los archivos de sesión conocidos.

Ejemplo de Hermes Agent

mcp_servers:
  finary:
    command: /path/to/finary-mcp/.venv/bin/finary-mcp
    env:
      FINARY_MCP_STATE_DIR: /private/path/to/finary-state
      FINARY_UAPI_PYTHON: /path/to/finary-uapi/.venv/bin/python
    tools:
      include:
        - finary_me
        - finary_organizations
        - finary_institution_connections
        - finary_portfolio
        - finary_transactions

Añade esto a través del flujo de trabajo MCP/configuración de Hermes en lugar de copiar credenciales en un archivo de configuración público. Reinicia el proceso de Hermes después de añadir un servidor para que la detección de herramientas se ejecute de nuevo.

Herramientas

Dependencia: finary-uapi

Este proyecto es un adaptador, no una reimplementación de la API de Finary. Llama a la CLI de finary-uapi desde el proyecto lasconic/finary_uapi, cuyo paquete está actualmente declarado en pyproject.toml como finary-uapi>=0.2.3,<0.3.

Esa dependencia usa endpoints de Finary no documentados y persiste una sesión local. Revisa su fuente y licencia antes de usar este servidor. Cuando se necesite una actualización upstream, pruébala primero en un entorno separado y fija una versión compatible aquí.

Desarrollo

pytest -q
python -m build

Las pruebas no usan una cuenta de Finary en vivo y no deben crear archivos de sesión. Antes de publicar, escanea los archivos preparados en busca de jwt.json, localCookiesMozilla.txt, credenciales, correos electrónicos, cookies y tokens.

Licencia

MIT. Ver LICENSE.