mcp-belvo

Name: mcp-belvo
Author: codespar

本地服务

github.com/codespar金融数据2754 周前更新

代码仓库

关于 mcp-belvo

mcp-belvo 是 Belvo 开放金融聚合服务的 MCP 服务，覆盖墨西哥、阿根廷和哥伦比亚等拉丁美洲市场。它面向需要读取银行账户、余额和交易数据的开发者与 Agent，提供 24 个工具。

主要功能

01通过 Belvo 连接金融机构
02查询账户、余额与交易记录
03获取收入、所有者与投资数据
04支持沙盒环境与 HTTP 传输
05提供 Belvo Connect Widget 令牌创建

适用场景

01在 Agent 中读取拉丁美洲用户的银行交易
02汇总多家机构的账户余额
03为财务分析或信贷评估提供金融数据

MCP 相关

该项目是一个 MCP 服务，将 Belvo API 的金融机构、链接、账户和交易等能力以工具形式暴露给 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-belvo": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-belvo"
      ],
      "env": {
        "BELVO_SECRET_ID": "<BELVO_SECRET_ID>",
        "BELVO_SECRET_PASSWORD": "<BELVO_SECRET_PASSWORD>",
        "BELVO_SANDBOX": "<BELVO_SANDBOX>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-belvo

需要配置的环境变量

BELVO_SECRET_ID密钥Secret ID for Belvo

BELVO_SECRET_PASSWORD密钥Secret password for Belvo

BELVO_SANDBOXSet to true to use sandbox environment

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@codespar/mcp-belvo0.2.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
page	number	否	页码
type	enum	否	机构类型bank \| fiscal \| gig \| employment
page_size	number	否	每页结果数
country_code	string	否	国家/地区代码筛选器（MX、CO、AR）

详细介绍

MCP Belvo

面向 Belvo 的 MCP 服务——LATAM（墨西哥、阿根廷、哥伦比亚）的开放金融聚合平台。

快速开始

# Set your credentials
export BELVO_SECRET_ID="your-secret-id"
export BELVO_SECRET_PASSWORD="your-secret-password"
export BELVO_SANDBOX=true  # Use sandbox environment

# Run via stdio
npx tsx packages/mexico/belvo/src/index.ts

# Run via HTTP
npx tsx packages/mexico/belvo/src/index.ts --http

环境变量

变量	必填	描述
`BELVO_SECRET_ID`	是	Belvo 控制面板中的 Secret ID
`BELVO_SECRET_PASSWORD`	是	Belvo 控制面板中的 Secret password
`BELVO_SANDBOX`	否	设为 `"true"` 以使用沙盒（默认：生产环境）
`MCP_HTTP`	否	设为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认：3000）

工具（24）

工具	用途
`list_institutions`	列出可用的金融机构
`create_link`	创建与金融机构的链接
`list_links`	列出现有链接
`get_accounts`	获取链接的账户
`get_balances`	获取链接的余额
`get_transactions`	获取链接的交易记录
`get_owners`	获取链接的所有者信息
`get_incomes`	获取链接的收入数据
`get_tax_returns`	获取链接的纳税申报数据（税务机构）
`get_investments`	获取链接的投资组合
`get_link`	按 ID 检索特定链接的详细信息
`delete_link`	按 ID 删除链接（及其所有关联数据）
`patch_link`	更新链接凭据，或在 MFA 后恢复（PATCH /api/links/）
`list_accounts`	列出已存储的账户（GET /api/accounts/），支持可选筛选条件
`get_account_detail`	按账户 ID 检索已存储的账户
`list_transactions`	列出已存储的交易记录（GET /api/transactions/），支持可选筛选条件
`get_transaction_detail`	按交易 ID 检索已存储的交易记录
`list_balances`	列出已存储的余额（GET /api/balances/），支持可选筛选条件
`list_owners`	列出已存储的所有者（GET /api/owners/）
`list_incomes`	列出已存储的收入（GET /api/incomes/）
`get_employment_records`	获取链接的就业记录（就业机构）
`get_invoices`	获取链接的发票（BR/MX 税务机构）
`get_receivables_transactions`	获取链接的应收账款交易（支付渠道／收单方数据）
`create_widget_token`	为 Belvo Connect Widget 创建短期访问令牌