mcp-mexico

mcp-mexico

AI エージェントにメキシコの公式公共データを提供する MCP サーバーです。Banxico の為替レートと金利、INEGI のインフレ率、UMA の値、ISR の税額表を取得できます。

スペイン語で読む

mcp-mexico を使用する Claude Code。応答の待ち時間は録画から短縮されています。

このツールを使う理由

AI アシスタントはメキシコの経済指標をでっち上げたり、古いデータを使ったりするため、結局 Banxico、INEGI、SAT で手作業で調べて貼り付けることになります。mcp-mexico を使えば、どの MCP クライアント（Claude Desktop、Claude Code、Cursor）からでも、データを直接取得できます。各結果には、公式の出典と適用日が記載されます。

ツール

ツール	返される内容	出典	トークン
get_fix_rate	最新または指定日の FIX USD/MXN 為替レート。週末と祝日には、直前の営業日の値を返します。	Banxico SIE	BANXICO_TOKEN
get_fix_rate_range	2 つの日付間の日次 FIX（最大 366 日間）。	Banxico SIE	BANXICO_TOKEN
get_interest_rate	Banxico の政策金利、28 日物 TIIE、翌日物 TIIE de Fondeo、または 28 日物 CETES の最新値または指定日の値。	Banxico SIE	BANXICO_TOKEN
get_interest_rate_range	2 つの日付間のいずれかの金利（最大 366 日間）。	Banxico SIE	BANXICO_TOKEN
get_inflation	指定月（デフォルトでは最新月）のINPC指数と月次、年次、年初来のインフレ率。	INEGI	INEGI_TOKEN
get_inflation_range	期間内の各月について同じデータを返します（最大 240 か月間）。	INEGI	INEGI_TOKEN
get_uma	UMA の日次、月次、年次の値（2020～2026 年）と有効期間。	INEGI	なし
get_isr_table	個人向け ISR 税額表（2020～2026 年）：月次（LISR Art. 96）と年次（LISR Art. 152）。	RMF の Anexo 8（SAT / DOF）	なし

get_uma と get_isr_table は、設定なしでオフライン動作します。データはパッケージに同梱されており、各表には出典文書と確認日が記載されています。

同梱されている UMA は 2026 年まで対応しています。2027 年 2 月 1 日以降は、パッケージが更新されるまで、get_uma は古い値を返すのではなくエラーを返します。

トークンを取得する

どちらも無料で、数分で取得できます。

1. Banxico：SIE API トークンのページを開き、CAPTCHA を解いて「Generar token」をクリックします。64 文字のトークンがページに表示されます。
2. INEGI：INEGI トークンフォームにメールアドレスを入力します。トークンはメールで届きます。

トークンは 1 つだけ、またはどちらも設定せずに始められます。トークンがないツールは、取得方法を説明するメッセージを返します。

インストール

uv が必要です。サーバーは uvx mcp-mexico で実行されます。自分で起動する必要はなく、MCP クライアントが起動します。

Claude Code

claude mcp add mcp-mexico -e BANXICO_TOKEN=your-token -e INEGI_TOKEN=your-token -- uvx mcp-mexico

Claude Desktop

claude_desktop_config.json にこれを追加し（Settings → Developer → Edit Config）、Claude Desktop を再起動します。

{
  "mcpServers": {
    "mcp-mexico": {
      "command": "uvx",
      "args": ["mcp-mexico"],
      "env": {
        "BANXICO_TOKEN": "your-token",
        "INEGI_TOKEN": "your-token"
      }
    }
  }
}

Cursor

同じ mcpServers ブロックを ~/.cursor/mcp.json に追加します。

試してみる

アシスタントに次のように尋ねてみてください。

• 「今日の FIX 為替レートはいくらですか？」
• 「2024 年 12 月のメキシコの年間インフレ率はいくらでしたか？」
• 「今年、30 UMA は何ペソですか？」
• 「2026 年の月次 ISR 税額表を使うと、給与が 25,000 ペソの場合、源泉徴収される税額はいくらですか？」

設定

変数	必須	説明
BANXICO_TOKEN	Banxico ツールの場合	Banxico SIE API トークン。
INEGI_TOKEN	INEGI ツールの場合	INEGI Indicators API トークン。

レスポンスはメモリ内にのみキャッシュされます。最新の値は最大1時間、過去のBanxicoの期間データは24時間、INPC系列は6時間キャッシュされます。ディスクには何も書き込まれません。

開発

uv sync
uv run pytest
uv run ruff check . && uv run ruff format --check . && uv run mypy .
uv run mcp-mexico      # starts the server over stdio

テストでネットワークにアクセスすることはありません。実際のAPIから記録したレスポンスを再生します。CONTRIBUTING.mdを参照してください。

免責事項

このプロジェクトはBanco de México、INEGI、SATとは無関係です。数値はそれぞれの公開情報に基づいていますが、税務または法的な判断に利用する前に、引用元を確認してください。

ライセンス

MIT © Diego Tepichin