Bcb Br MCP

🚀 BCB BR MCP Server

這是一個用於訪問巴西中央銀行（SGS/BCB）時間序列數據的MCP（Model Context Protocol）服務器。它允許你直接在Claude等AI助手工具中查詢經濟和金融指標，如基準利率（Selic）、全國廣義消費者物價指數（IPCA）、匯率、**國內生產總值（PIB）**等。

🚀 快速開始

本服務器可讓你在Claude等AI助手工具中直接查詢巴西中央銀行的經濟和金融指標。你可以通過配置Claude Desktop或使用提供的工具來實現這一功能。

✨ 主要特性

• 歷史序列查詢：通過代碼和日期篩選來查詢序列值。
• 最新值獲取：獲取序列的最新N個值。
• 元數據查詢：獲取序列的詳細信息（如週期性、來源等）。
• 熱門序列目錄：包含150多個經濟指標，分為12個類別。
• 智能搜索：通過搜索詞（有無重音均可）查找序列。
• 當前指標查詢：獲取主要經濟指標的最新值。
• 變化計算：計算不同週期之間的百分比變化，並提供統計信息。
• 序列比較：在同一時期比較多個序列。

📦 安裝指南

Claude Desktop

將以下配置添加到Claude Desktop的配置文件中：

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

選項1：通過 npx（推薦）

{
    "mcpServers": {
        "bcb-br": {
            "command": "npx",
            "args": ["-y", "bcb-br-mcp"]
        }
    }
}

選項2：全局安裝

npm install -g bcb-br-mcp

{
    "mcpServers": {
        "bcb-br": {
            "command": "bcb-br-mcp"
        }
    }
}

💻 使用示例

基礎用法

查詢當前基準利率

當前基準利率是多少？
→ 使用 bcb_indicadores_atuais

查詢2024年全國廣義消費者物價指數歷史數據

顯示2024年每月的全國廣義消費者物價指數
→ 使用 bcb_serie_valores，代碼為 433，起始日期為 2024-01-01，結束日期為 2024-12-31

列出通貨膨脹指標

有哪些通貨膨脹序列可用？
→ 使用 bcb_series_populares，類別為 "Inflação"

搜索與美元相關的序列

搜索與美元相關的序列
→ 使用 bcb_buscar_serie，關鍵詞為 "dolar"（即使沒有重音也能正常工作）

計算美元的變化

過去12個月美元的變化是多少？
→ 使用 bcb_variacao，代碼為 1，週期為 12

比較全國廣義消費者物價指數、廣義市場價格指數和全國消費者物價指數

比較2024年全國廣義消費者物價指數、廣義市場價格指數和全國消費者物價指數
→ 使用 bcb_comparar，代碼為 [433, 189, 188]，起始日期為 2024-01-01，結束日期為 2024-12-31

📚 詳細文檔

可用工具

序列目錄（150+）

本服務器包含一個目錄，其中有150多個序列，分為12個類別。

利率和費率

通貨膨脹（30+序列）

匯率（15+序列）

經濟活動（25+序列）

就業（10+序列）

財政（10+序列）

外部部門（15+序列）

信貸（30+序列）

貨幣總量

儲蓄

市場指數

預期（焦點調查）

查找其他序列

SGS擁有超過18000個時間序列。要查找其他序列的代碼：

1. 訪問巴西中央銀行SGS門戶
2. 使用搜索功能查找所需序列
3. 記錄序列代碼
4. 在本服務器的工具中使用該代碼

🔧 技術細節

健壯性

• 超時設置：每個請求的超時時間為30秒（避免卡頓）。
• 自動重試：使用指數退避算法進行3次重試（1秒、2秒、4秒）。
• 錯誤處理：以葡萄牙語提供清晰的錯誤消息。

智能搜索

bcb_buscar_serie工具會對搜索詞進行標準化處理，即使沒有重音也能找到序列：

• "inflacao" → 找到 "Inflação"
• "cambio" → 找到 "Câmbio"
• "credito" → 找到 "Crédito"

開發

要求

• Node.js >= 18.0.0

環境搭建

git clone https://github.com/SidneyBissoli/bcb-br-mcp.git
cd bcb-br-mcp
npm install

構建

npm run build

本地測試

npm run dev

或者使用MCP Inspector：

npx @modelcontextprotocol/inspector npm run dev

巴西中央銀行API

本服務器使用巴西中央銀行的公共API：

• 基礎端點：https://api.bcb.gov.br/dados/serie/bcdata.sgs.{codigo}/dados
• 格式：JSON
• 認證：無（公共API）
• 文檔：巴西中央銀行開放數據

更新日誌

v1.1.0

• ✨ 新增 bcb_variacao 工具，用於計算百分比變化。
• ✨ 新增 bcb_comparar 工具，用於比較多個序列。
• 🔧 請求超時時間設置為30秒。
• 🔧 使用指數退避算法進行自動重試（3次）。
• 🔧 搜索詞標準化處理（接受無重音的術語）。
• 📊 添加額外統計信息（最大值、最小值、平均值、振幅）。

v1.0.0

• 🎉 初始版本發佈。
• 提供6個基本工具。
• 包含150多個序列的目錄。

貢獻

歡迎貢獻代碼！請按照以下步驟操作：

1. Fork本倉庫。
2. 創建一個新的功能分支 (git checkout -b feature/nova-feature)。
3. 提交你的更改 (git commit -m '添加新功能')。
4. 將更改推送到分支 (git push origin feature/nova-feature)。
5. 打開一個Pull Request。

📄 許可證

本項目採用MIT許可證，請查看LICENSE瞭解詳細信息。

作者

Sidney Bissoli

• GitHub: @SidneyBissoli
• Email: sbissoli76@gmail.com

有用鏈接

• 巴西中央銀行SGS門戶
• 巴西中央銀行開放數據
• Model Context Protocol
• MCP Registry
• npm: bcb-br-mcp