内容
# 大型MCP B3服务器
**完整的B3数据MCP服务器** — 报价、基金、股息、基本面、期权和指数。
[](https://www.npmjs.com/package/big-mcp-b3)
[](LICENSE)
[](https://modelcontextprotocol.io)
## ✨ 功能
- **10种工具** 用于巴西金融市场数据
- **无需API密钥** — 立即与brapi.dev（免费）一起使用
- **现代TypeScript** — 强类型，async/await
- **零重依赖** — 仅MCP SDK + Zod
- **兼容** Claude Desktop、Cursor、VS Code、Hermes
## 🛠️ 可用工具
| 工具 | 描述 | API |
|------|-----------|-----|
| `cotacao_ativo` | 实时报价 | brapi.dev |
| `historico_ativo` | 价格历史 | brapi.dev |
| `proventos_ativo` | 股息、JCP、红利 | brapi.dev |
| `fiis_lista` | 房地产基金列表 | CVM + brapi.dev |
| `fii_detalhes` | 特定FII的详细信息 | brapi.dev |
| `fundamentus_ativo` | 基本面分析（P/L、ROE、利润率） | fundamentus.com.br |
| `indices_b3` | Ibovespa、IFIX、IDIV、SMLL等 | brapi.dev |
| `opcoes_ativo` | 期权链（call和put） | brapi.dev |
| `comparar_ativos` | 比较多个资产 | brapi.dev |
## 🚀 快速开始
### Claude Desktop
添加到 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"big-mcp-b3": {
"command": "npx",
"args": ["-y", "big-mcp-b3"],
"env": {
"BRAPI_TOKEN": "您的令牌"
}
}
}
}
```
### Cursor
添加到 `.cursor/mcp.json`:
```json
{
"servers": {
"big-mcp-b3": {
"command": "npx",
"args": ["-y", "big-mcp-b3"],
"env": {
"BRAPI_TOKEN": "您的令牌"
}
}
}
}
```
### VS Code
创建 `.vscode/mcp.json`:
```json
{
"servers": {
"big-mcp-b3": {
"command": "npx",
"args": ["-y", "big-mcp-b3"],
"env": {
"BRAPI_TOKEN": "您的令牌"
}
}
}
}
```
### Hermes
```bash
hermes mcp add big-mcp-b3 -- npx -y big-mcp-b3
```
### 本地开发
```bash
# 克隆仓库
git clone https://github.com/danielvm-git/big-mcp-b3.git
cd big-mcp-b3
# 安装依赖
npm install
# 开发模式运行
npm run dev
# 生产环境构建
npm run build
```
## 📖 使用示例
配置MCP服务器后，用自然语言提问：
> **报价：** "当前PETR4的报价是多少？"
> **历史：** "显示VALE3过去3个月的历史"
> **股息：** "TAEE11支付了哪些股息？"
> **基金：** "列出购物中心的基金"
> **指数：** "今天的Ibovespa怎么样？"
> **期权：** "PETR4的2026年期权有哪些？"
> **比较：** "比较PETR4、VALE3和ITUB4"
## ⚙️ 配置
### 环境变量
| 变量 | 必需 | 描述 |
|----------|------------|-----------|
| `BRAPI_TOKEN` | 否 | brapi.dev令牌（免费，100次请求/天） |
| `REQUEST_TIMEOUT` | 否 | 请求超时时间（毫秒，默认值：30000） |
| `MAX_RETRIES` | 否 | 最大重试次数（默认值：3） |
### 获取brapi.dev令牌
1. 访问 [brapi.dev](https://brapi.dev)
2. 创建免费账户
3. 从仪表盘复制令牌
4. 添加到 `.env` 或MCP配置中
**注意：** 服务器无需令牌即可运行（有请求限制）。
## 📊 可用数据
### 股票
- 实时报价
- 价格历史（1天至10年）
- 股息和JCP
- 期权（call和put）
### 房地产基金
- 完整列表（CVM）
- 报价和变动
- 已支付股息
### 指数
- Ibovespa（^BVSP）
- IFIX（^IFIX）
- IDIV（^IDIV）
- SMLL（^SMLL）
- 更多...
## 🔧 开发
### 项目结构
```
big-mcp-b3/
├── src/
│ ├── index.ts # 入口点
│ ├── types/ # 类型定义
│ ├── services/ # API服务
│ │ ├── brapi.ts # brapi.dev
│ │ └── cvm.ts # CVM开放数据
│ └── tools/ # MCP工具
│ ├── cotacao.ts # 报价
│ ├── historico.ts # 历史
│ ├── proventos.ts # 股息
│ ├── fiis.ts # 基金
│ ├── fundamentus.ts# 基本面分析
│ ├── indices.ts # 指数
│ ├── opcoes.ts # 期权
│ └── comparar.ts # 比较
├── tests/
├── docs/
├── package.json
├── tsconfig.json
└── README.md
```
### 命令
```bash
npm run dev # 开发模式运行
npm run build # 编译TypeScript
npm run start # 运行编译后的版本
npm test # 运行测试
```
## 📝 许可证
MIT — 查看 [LICENSE](LICENSE) 获取详细信息。
## 🤝 贡献
欢迎贡献！查看 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
## 📧 联系
- GitHub：[@danielvm-git](https://github.com/danielvm-git)
- 问题： [GitHub Issues](https://github.com/danielvm-git/big-mcp-b3/issues)
---
**为巴西投资者打造 ❤️**
