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