Banxico (Banco de México)

🇲🇽 mcp-banxico

由社区维护的 Model Context Protocol (MCP) 服务，用于将人工智能助手（Claude Desktop、Cursor、Cline、Gemini CLI）连接到 墨西哥银行（Banxico）的经济信息系统（SIE）。

让你的模型和 AI Agent 实时查询官方汇率（USD/MXN）、通胀率（INPC）、UDIS 价值、银行间利率（TIIE）以及墨西哥的任何官方经济序列。

独立项目。 与墨西哥银行无关，也未获得其背书。此项目使用 SIE 公共 API。如果在本地安装，需要使用你自己的免费令牌；下方的远程服务端点则不需要令牌。

▶️ 视频演示

十分钟完整演示：一个本地模型（Ollama 上的 Qwen 2.5）和 Claude Desktop 从 “我无法实时访问” 转变为能够给出官方汇率。关键时刻在第 2:52 分钟。

📈 实时数据

banxico-mcp.duckdns.org：汇率（美元、欧元、英镑、加元和日元）、利率、CETES 收益率曲线、通胀率、UDIS 和国际储备，共 22 项官方指标，每个工作日更新。每项数据均可下载为 CSV。该网站与此服务的远程服务端点使用同一域名。

---

🏗️ 架构

flowchart LR
    subgraph Clientes["Clientes MCP / AI"]
        Claude["Claude Desktop"]
        Cursor["Cursor IDE"]
        Cline["Cline / VS Code"]
        Agents["AI Agents"]
    end

    subgraph Server["mcp-banxico"]
        MCP["MCP Protocol (stdio)"]
        Tools["Herramientas Económicas"]
    end

    subgraph Banxico["Banco de México"]
        SIE["API SIE Banxico"]
    end

    Clientes <-->|JSON-RPC / stdio| MCP
    MCP --> Tools
    Tools <-->|HTTPS + Token| SIE

---

⚡ 快速安装和使用

选项 0：远程服务端点（无需安装，无需令牌）

已有一个公开托管的实例。无需安装，也无需申请自己的 Banxico 令牌：

https://banxico-mcp.duckdns.org/mcp

传输方式为 streamable-http。在 Claude Desktop 中：

{
  "mcpServers": {
    "banxico": {
      "type": "streamable-http",
      "url": "https://banxico-mcp.duckdns.org/mcp"
    }
  }
}

这是运行在自有基础设施上的社区服务，每个 IP 的请求数有限制。 如需高强度使用或用于生产环境，请使用自己的令牌在本地安装： 这样就不必依赖此实例是否可用。

手动测试（curl 或 Postman）

该端点通过 HTTP POST 使用 JSON-RPC 2.0。需要发送两个请求：一个用于 建立会话，另一个用于调用工具。

1. 建立会话。 响应中会包含 mcp-session-id 标头：

curl -i -X POST https://banxico-mcp.duckdns.org/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "curl", "version": "1" }
    }
  }'

2. 调用工具，在标头中传入该 ID：

curl -X POST https://banxico-mcp.duckdns.org/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'mcp-session-id: EL_ID_DEL_PASO_1' \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": { "name": "tipo_cambio_usd", "arguments": {} }
  }'

响应（内容以 SSE 事件形式传输，位于 data: 行中）：

{
  "serie": "TIPO_CAMBIO_FIX",
  "id_serie": "SF43718",
  "nombre": "Tipo de cambio FIX (Pesos por Dólar)",
  "unidad": "Pesos por dólar",
  "fecha": "28/09/2026",
  "valor": "17.8413"
}

其他 params 示例：

{ "name": "inflacion_mexico",         "arguments": { "tipo": "anual" } }
{ "name": "valor_udis",               "arguments": {} }
{ "name": "tasa_interes_banxico",     "arguments": { "tipo": "objetivo" } }
{ "name": "reservas_internacionales", "arguments": {} }
{ "name": "consultar_serie_sie",      "arguments": { "id_serie": "SF43718",
                                                     "fecha_inicio": "2026-09-01",
                                                     "fecha_fin": "2026-09-28" } }

使用 Postman 测试时有两点容易造成困惑。 从第二个请求开始，必须提供 mcp-session-id 标头： 如果不提供，响应将为 400。如果只发送 Accept: application/json， 则会得到 406 — 服务器要求同时接受两种类型，也可以完全省略 此标头。

选项 1：使用 uvx（推荐用于 Claude Desktop 和 Cursor）

uvx mcp-banxico

选项 2：使用 pip

pip install mcp-banxico
mcp-banxico

---

🛠️ AI 客户端配置

1. Claude Desktop

将以下配置添加到你的 claude_desktop_config.json 文件中：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "banxico": {
      "command": "uvx",
      "args": ["mcp-banxico"],
      "env": {
        "BANXICO_TOKEN": "TU_TOKEN_DE_BANXICO_AQUI"
      }
    }
  }
}

2. Cursor IDE

在 Settings -> Features -> MCP Servers -> Add new MCP server 中：

• Name： banxico
• Type： command
• Command： uvx mcp-banxico

---

📊 AI 可用工具

工具	Banxico 系列	描述
tipo_cambio_usd	SF43718 / SF60653	查询今日或指定日期范围内的官方比索/美元汇率（FIX 或结算汇率）。
inflacion_mexico	SP30578 / SP30577	查询基于 INPC 的墨西哥年度或月度总体通胀率。
valor_udis	SP68257	查询以墨西哥比索计价的 UDIS 官方价值。
tasa_interes_banxico	SF43783 / SF61745	查询 28 天 TIIE 或银行间隔夜拆借目标利率。
reservas_internacionales	SF43707	墨西哥银行的国际储备余额，单位为百万美元。
consultar_serie_sie	任意	高级查询，可查询 Banxico 通用目录中的任意系列 ID。

---

🌐 托管你自己的远程实例

mcp-banxico --transport streamable-http \
            --host 127.0.0.1 --port 8005 \
            --allowed-host tu-dominio.example

在反向代理后，必须指定 --allowed-host：HTTP 传输会验证 Host 标头，以防范 DNS 重绑定攻击；如果未声明公共名称，则会对所有请求返回 421。

默认 1 小时的内存缓存（可通过 BANXICO_CACHE_TTL 调整）可避免共享令牌耗尽 SIE 的限额。

---

🔑 如何获取 Banxico 令牌

Banxico 为其 API 提供免费公开访问：

1. 访问：Banxico SIE 令牌门户
2. 输入你的邮箱并申请令牌。你会立即收到令牌。
3. 在你的环境中进行配置：

   export BANXICO_TOKEN="tu_token_aqui"
   

---

🧪 本地验证

你可以运行以下命令，测试令牌和连接是否正常：

mcp-banxico --test

预期输出：

============================================================
mcp-banxico v0.1.0 - Verificación de Conexión a Banxico SIE
============================================================
Consultando tipo de cambio FIX (serie SF43718)...
-> Éxito: Fecha 18/09/2026, Valor: $19.92 MXN por USD

---

💻 开发与测试

如需在本地贡献：

git clone https://github.com/nanisadw3/mcp-banxico.git
cd mcp-banxico
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest --cov=mcp_banxico

---

📄 许可证

根据 MIT 许可证分发。详情请参阅 LICENSE 文件。

由 Inaki Sobera (nanisadw3) 在墨西哥倾情开发 ❤️。