finary-mcp

一个刻意只读的 Model Context Protocol 服务器，用于 Finary，构建在非官方的 finary-uapi 客户端之上。

[!WARNING] 本项目独立于 Finary，未经 Finary 认可、支持或维护。它通过 finary-uapi 依赖私有的、未记录的端点；任一项目都可能在没有通知的情况下中断。这不是财务、税务、法律或投资建议。

安全模型

finary-mcp 有意成为一个狭窄的、只读的适配器：

• 它仅暴露个人资料、组织、机构、投资组合和交易查询。

• 它没有登录、账户导入、创建、更新、删除、转账、交易或通用 CLI 工具。

• 它从固定的允许列表中构建 finary-uapi 命令，不使用 shell。

• 过滤器值在执行前经过验证。

• 当请求失败时，它不返回上游的 stdout/stderr，因为上游登录流程可能会打印会话材料。

• 其状态目录是显式的（FINARY_MCP_STATE_DIR）；它不会在任意工作目录中查找令牌。

这减少了通过 MCP 的意外写入。如果另一个进程可以读取您的会话文件，它并不能使机器安全。仅为您信任的账户和个人资料运行服务器。

重要的认证注意事项

“只读”指的是 Finary 投资组合数据。finary-uapi 在请求前刷新其 Clerk 会话，并可能重写 jwt.json；因此，即使没有 MCP 工具更改 Finary 数据，私有状态目录也必须保持对本地服务账户可写。服务器永远不会返回该文件、cookie 或子进程诊断信息。

finary-uapi 还带来了 fuzzywuzzy 作为传递的 GPL-2.0 依赖。请审查上游依赖图和许可影响，以确定您的预期分发或部署。

Related MCP server: C6 Bank MCP

先决条件

• Python 3.10+。

• 已由 finary-uapi 创建的本地 Finary 会话。

• 一个包含 jwt.json 和 localCookiesMozilla.txt 的私有目录，目录权限为 0700，文件权限为 0600。

服务器本身不支持 Google OAuth。请遵循 finary-uapi 支持的认证流程来创建或续订本地会话。切勿将密码、TOTP 代码、JWT、cookie 导出或会话文件发送给代理、仓库、问题跟踪器或聊天。

安装

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

从检出进行开发：

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

配置 MCP 主机

将 FINARY_MCP_STATE_DIR 设置为存放 Finary 会话的目录。如果 finary-uapi 安装在单独的虚拟环境中，请将 FINARY_UAPI_PYTHON 设置为该环境的 Python 可执行文件。

通用 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"
      }
    }
  }
}

使用绝对路径。状态目录是私有数据，绝不能提交。提供的 .gitignore 排除了已知的会话文件。

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

通过 Hermes 的 MCP/配置工作流添加此配置，而不是将凭据复制到公共配置文件中。添加服务器后重启 Hermes 进程，以便重新运行工具发现。

工具

依赖：finary-uapi

本项目是一个适配器，而不是 Finary API 的重新实现。它调用 lasconic/finary_uapi 项目中的 finary-uapi CLI，其包目前在 pyproject.toml 中声明为 finary-uapi>=0.2.3,<0.3。

该依赖使用未记录的 Finary 端点并持久化本地会话。使用此服务器前请审查其源代码和许可证。当需要上游升级时，先在单独的环境中测试，然后在此处固定兼容版本。

开发

pytest -q
python -m build

测试不使用真实的 Finary 账户，且不得创建会话文件。发布前，请扫描暂存文件中的 jwt.json、localCookiesMozilla.txt、凭据、电子邮件、cookie 和令牌。

许可证

MIT。参见 LICENSE。