Banxico (Banco de México)

🇲🇽 mcp-banxico

AI アシスタント（Claude Desktop、Cursor、Cline、Gemini CLI）を**メキシコ銀行（Banxico）の経済情報システム（SIE）**に接続する、コミュニティ運営の Model Context Protocol（MCP） サーバーです。

モデルや AI エージェントから、公式為替レート（USD/MXN）、インフレ率（INPC）、UDIS の価値、銀行間金利（TIIE）、メキシコの公式経済指標をリアルタイムで照会できます。

独立したプロジェクトです。 メキシコ銀行とは提携しておらず、同銀行の支援も受けていません。SIE の公開 API を利用しています。ローカルにインストールする場合は、ご自身の無料トークンが必要です。下記のリモートエンドポイントでは必要ありません。

▶️ 動画デモ

ノーカットの10分間の動画です。ローカルモデル（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 を使用します。リクエストは2つです。1つ目で セッションを開始し、2つ目でツールを呼び出します。

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 から試す際に混乱しやすい点が2つあります。 2回目以降のリクエストでは 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	メキシコ銀行の国際準備高残高を、百万 USD 単位で取得します。
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 トランスポートは DNS リバインディング攻撃に対して Host ヘッダーを検証します。公開ホスト名を指定しない場合、すべてのリクエストに 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) が開発しました。