Banxico MCP

🚀 墨西哥銀行MCP服務器

這是一個模型上下文協議（MCP）服務器，用於訪問墨西哥銀行（Banxico）的SIE API，以檢索美元/墨西哥比索的匯率數據和其他經濟指標。

✨ 主要特性

• 即時匯率：從墨西哥銀行獲取最新的美元/墨西哥比索匯率。
• 歷史數據：可自定義範圍，檢索歷史匯率數據。
• 系列元數據：訪問經濟數據系列的詳細信息。
• 日期範圍查詢：獲取特定日期範圍內的匯率數據。
• MCP兼容：可與Claude Desktop、Gemini CLI和其他MCP客戶端配合使用。

📦 安裝指南

前提條件

1. 系統中安裝有 Python 3.10+。
2. 安裝 uvx（推薦）或 uv 包管理器。
3. 獲取 墨西哥銀行API令牌：可從 墨西哥銀行SIE API 獲取。

安裝方法

選項1：直接從GitHub安裝（自動更新）⭐ 推薦

此方法在重啟MCP客戶端時會自動獲取最新更新： MCP客戶端配置：

"banxico": {
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/cfocoder/banxico_mcp",
    "banxico-mcp-server"
  ],
  "env": {
    "BANXICO_API_TOKEN": "your_token_here"
  }
}

無需手動安裝！ uvx將自動下載並運行最新版本。

選項2：下載單個文件（手動更新）

如果您希望將文件下載到本地：

1. 安裝uvx（如果尚未安裝）：

   pip install uv
   

2. 下載服務器文件：

   curl -O https://raw.githubusercontent.com/cfocoder/banxico_mcp/main/banxico_mcp_server.py
   

3. MCP客戶端配置：

   "banxico": {
     "command": "uvx",
     "args": [
       "--python", "3.12",
       "--from", "fastmcp",
       "--with", "httpx",
       "--",
       "python",
       "/absolute/path/to/banxico_mcp_server.py"
     ],
     "env": {
       "BANXICO_API_TOKEN": "your_token_here"
     }
   }
   

   獲取更新： 當有新功能添加時，重新下載文件。

選項3：傳統安裝

1. 克隆倉庫：

   git clone https://github.com/cfocoder/banxico_mcp.git
   cd banxico_mcp
   

2. 安裝依賴項：

   pip install fastmcp httpx
   

3. 運行服務器：

   BANXICO_API_TOKEN=your_token_here python banxico_mcp_server.py
   

🔧 配置說明

獲取墨西哥銀行API令牌

1. 訪問 墨西哥銀行令牌註冊。
2. 填寫表單以請求API令牌。
3. 您將通過電子郵件收到令牌。

配置MCP客戶端

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "banxico": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "fastmcp",
        "--with", "httpx",
        "--",
        "python",
        "/absolute/path/to/banxico_mcp_server.py"
      ],
      "env": {
        "BANXICO_API_TOKEN": "your_banxico_token_here"
      }
    }
  }
}

Gemini CLI

添加到 ~/.gemini/settings.json：

{
  "mcpServers": {
    "banxico": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "fastmcp",
        "--with", "httpx",
        "--",
        "python",
        "/absolute/path/to/banxico_mcp_server.py"
      ],
      "env": {
        "BANXICO_API_TOKEN": "your_banxico_token_here"
      }
    }
  }
}

💻 使用示例

配置好MCP客戶端後，您可以進行如下提問：

匯率相關

• "當前美元兌墨西哥比索的匯率是多少？"
• "顯示過去10天的美元/墨西哥比索匯率。"
• "獲取2024年1月1日至2024年1月31日的匯率數據。"
• "美元/墨西哥比索系列的元數據是什麼？"

通脹數據相關

• "墨西哥當前的月度通脹率是多少？"
• "顯示過去一年的年度通脹數據。"
• "獲取過去6個月的累計通脹數據。"

利率相關

• "當前28天期的墨西哥短期國債（CETES）利率是多少？"
• "顯示過去一個月的CETES利率。"

金融指標相關

• "當前的投資單位（UDIS）價值是多少？"
• "顯示墨西哥銀行的儲備資產。"
• "獲取墨西哥銀行的最新金融指標。"

勞動力市場相關

• "墨西哥當前的失業率是多少？"
• "顯示過去一年的失業趨勢。"
• "過去2年失業率有何變化？"

📚 詳細文檔

可用工具

API參考

服務器使用 墨西哥銀行SIE API，以下是相關端點：

匯率相關

• 最新數據：/series/SF63528/datos/oportuno
• 歷史數據：/series/SF63528/datos
• 系列元數據：/series/SF63528
• 日期範圍：/series/SF63528/datos/{start_date}/{end_date}

通脹數據相關

• 月度通脹：/series/SP30577/datos
• 累計通脹：/series/SP30579/datos
• 年度通脹：/series/SP30578/datos

金融指標相關

• 投資單位（UDIS）：/series/SP68257/datos
• 28天期墨西哥短期國債（CETES）：/series/SF282/datos
• 墨西哥銀行儲備：/series/SF308843/datos

勞動力市場相關

• 失業率：/series/SL1/datos

🛠️ 開發說明

項目結構

banxico-mcp-server/
├── banxico_mcp_server.py    # 主服務器文件
├── README.md                # 本文件
├── LICENSE                  # MIT許可證
├── CONTRIBUTING.md          # 開發指南
└── docs/                    # 文檔和示例
    ├── EXTENDING.md         # 添加新端點的指南
    └── examples/            # 配置示例
        ├── claude-desktop.md
        ├── continue.md
        ├── env-template.md
        ├── gemini-cli.md
        └── vscode-cline.md

測試

若要在不使用MCP客戶端的情況下測試服務器：

# 設置您的令牌
export BANXICO_API_TOKEN=your_token_here

# 運行服務器並設置超時以測試啟動
timeout 5s python banxico_mcp_server.py && echo "服務器啟動成功"

添加新工具

有關添加新的墨西哥銀行API端點的詳細說明，請參閱 EXTENDING.md。

🐞 故障排除

常見問題

1. “未設置BANXICO_API_TOKEN環境變量”
   • 確保您的API令牌已在MCP客戶端設置中正確配置。
2. “無法檢索數據”
   • 檢查您的互聯網連接。
   • 驗證您的API令牌是否有效。
   • 確保墨西哥銀行API可訪問。
3. 服務器無法啟動
   • 驗證是否安裝了Python 3.10+。
   • 檢查uvx或所需依賴項是否可用。

調試模式

使用調試日誌運行：

BANXICO_API_TOKEN=your_token PYTHONPATH=. python -c "
import logging
logging.basicConfig(level=logging.DEBUG)
from banxico_mcp_server import mcp
mcp.run()
"

🤝 貢獻指南

1. Fork倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m '添加出色的功能'）。
4. 將更改推送到分支（git push origin feature/amazing-feature）。
5. 打開拉取請求。

📄 許可證

本項目採用MIT許可證 - 有關詳細信息，請參閱 LICENSE 文件。

🙏 致謝

• 墨西哥銀行（Banxico） 提供了SIE API。
• 模型上下文協議 提供了協議規範。
• FastMCP 提供了出色的MCP服務器框架。

🔗 相關項目

• MCP服務器集合
• Claude Desktop MCP指南
• Gemini CLI文檔