Bcb Br MCP

BCB BR MCP服务器

](https://www.npmjs.com/package/bcb-br-mcp) ](https://www.npmjs.com/package/bcb-br-mcp)    

阅读中文

MCP（模型上下文协议）服务器，用于访问巴西中央银行的时间序列数据（SGS/BCB）。

查询经济和财务指标，如 基本利率 （利率）， IPCA （通货膨胀）， 汇率, 国内生产总值以及更多，直接来自像克劳德这样的人工智能助手。

如果你觉得这个项目有用，请考虑给它一个 。它可以帮助其他人发现项目！

特性

• 历史数据 -使用日期过滤器按代码查询时间序列值
• 最新值 -获取任何系列的最新N值
• 元数据 -关于系列的详细信息（频率、来源等）
• 热门系列目录 -150+经济指标分为12类
• 智能搜索 -按关键字查找系列（不区分重音）
• 当前指标 -关键经济指标的最新值
• 变化计算 -统计期间的百分比变化
• 系列比较 -比较同一时期的多个系列

可用工具

安装

史密斯路（推荐）

访问 士美利商业银行 并按照MCP客户端的安装说明进行操作。

通过URL（Claude.ai、Claude Desktop、任何MCP客户端）

直接使用HTTP端点，无需安装：

https://bcb.sidneybissoli.workers.dev

通过npx（克劳德桌面）

添加到您的Claude Desktop配置文件中：

窗户： %APPDATA%\Claude\claude_desktop_config.json

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

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

通过全局安装

npm install -g bcb-br-mcp

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

使用示例

获取当前的Selic价格

What is the current Selic interest rate?
→ Uses bcb_indicadores_atuais

2024年IPCA历史

Show me the monthly IPCA for 2024
→ Uses bcb_serie_valores with code 433, dataInicial 2024-01-01, dataFinal 2024-12-31

列出通货膨胀指标

What inflation series are available?
→ Uses bcb_series_populares with category "Inflação"

搜索美元汇率系列

Search for series related to the dollar
→ Uses bcb_buscar_serie with term "dolar" (works without accents)

计算美元/巴西雷亚尔的变动

What was the USD/BRL variation over the last 12 months?
→ Uses bcb_variacao with code 1 and periodos 12

比较IPCA、IGP-M和INPC

Compare IPCA, IGP-M, and INPC in 2024
→ Uses bcb_comparar with codes [433, 189, 188], dataInicial 2024-01-01, dataFinal 2024-12-31

系列目录（150+）

该服务器包括一个由12个类别组成的150多个系列的目录。

利率

通货膨胀（30+系列）

汇率（15+系列）

经济活动（25+系列）

就业（10+系列）

财政（10+系列）

对外部门（15+系列）

学分（30+系列）

货币总量

储蓄

市场指数

期望（焦点调查）

寻找其他系列

SGS数据库包含18000多个时间序列。要查找其他系列的代码：

1. 访问 BCB SGS门户
2. 搜索所需系列
3. 注意系列代码
4. 将该代码与此服务器的工具一起使用

技术细节

鲁棒性

• 超时：每个请求30秒（防止挂起）
• 自动重试：3次指数回退尝试（1s、2s、4s）
• 错误处理：清除错误消息

智能搜索

这 bcb_buscar_serie 该工具使搜索词标准化，即使没有葡萄牙语口音，您也可以找到系列：

• "inflacao" → finds “通货膨胀”
• "cambio" → finds “交换”
• "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

本地测试（stdio）

npm run dev

本地测试（HTTP worker）

npm run dev:worker

或使用MCP检查器：

npx @modelcontextprotocol/inspector npm run dev

BCB API

此服务器使用巴西中央银行的公共API：

• 基本端点： https://api.bcb.gov.br/dados/serie/bcdata.sgs.{code}/dados
• 格式： JSON
• 身份验证： 无（公共API）
• 文档： BCB开放数据

更新日志

v1.2.0版本

• 通过Cloudflare Workers实现HTTP端点(https://bcb.sidneybissoli.workers.dev)
• 发表于Smithery.ai
• 重构：提取工具逻辑 src/tools.ts （在stdio和HTTP之间共享）

v1.1.0版本

• 新工具 bcb_variacao 用于百分比变化计算
• 新工具 bcb_comparar 用于比较多个系列
• 请求超时30秒
• 指数回退自动重试（3次尝试）
• 标准化搜索（不区分重音）
• 其他统计数据（最大值、最小值、平均值、范围）

v1.0.0

• 初始版本
• 6基本工具
• 150+系列目录

贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/new-feature)
3. 提交您的更改(git commit -m 'Add new feature')
4. 推到分支(git push origin feature/new-feature)
5. 打开拉取请求

许可证

麻省理工学院-见 许可证 了解详情。

作者

西德尼·达席尔瓦·佩雷拉·比索利

• github： @西德尼·比索里
• 电子邮件：sbissoli76@gmail.com

实用链接

• BCB SGS门户
• BCB开放数据
• 模型上下文协议
• MCP注册表
• 史密斯利银行：bcb br mcp

-