Tesouro Direto Mcp

🚀 财政直投 MCP 服务器

这是一个用于与 Tesouro Direto API 集成的 Model Context Protocol (MCP) 服务器实现。借助该服务器，通过 MCP 兼容客户端，用户能够以自然语言的方式访问巴西国债数据，为获取相关信息提供了极大的便利。

🚀 快速开始

本项目可助力你通过自然语言便捷访问巴西国债数据。你可以使用日常语言查询市场数据、债券详细信息，还能按类型、到期日等标准搜索/过滤债券。

✨ 主要特性

• 自然语言查询：支持使用日常语言查询市场数据、债券详细信息，以及按类型、到期日和其他标准搜索/过滤债券。
• MCP 工具丰富：
  • market_data：获取一般国债市场数据（开盘/收盘时间，状态）。
  • bond_data：获取特定债券的详细信息。
  • search_bonds：按类型、到期日和其他标准搜索/过滤债券。
• 智能缓存机制：基于 API 更新时间戳的 10 分钟内存缓存，既能减少 API 调用次数，又能确保数据新鲜度。

📦 安装指南

通过 npm 安装

示例 JSON 配置文件（用于 Cursor/Claude）

使用 npx，将以下内容添加到 ~/.cursor/mcp.json 或 claude_desktop_config.json：

{
"mcpServers": {
"tesouro-direto": {
"command": "npx",
"args": [
"-y",
"tesouro-direto-mcp"
],
"env": {
"USE_MCP_CACHE": "true"
}
}
}
}

从源代码构建

# 克隆仓库
git clone https://github.com/AtilioA/tesouro-direto-mcp.git
cd tesouro-direto-mcp

# 安装依赖项
pnpm install

# 构建项目
pnpm run build

💻 使用示例

基础用法

在 MCP 兼容客户端中，您可以使用以下提示进行操作：

• "显示所有可用的财政直投债券"
• "获取 IPCA+2029 债券的详细信息"
• "搜索 2045 年之后到期的 IPCA 债券"
• "当前国债市场的状态是什么？"
• "提供收益率最高的前三种债券（包括 IPCA 和固定利率债券）的详细分析。"

📚 详细文档

工具说明

• market_data：用于获取一般国债市场数据，包括开盘和收盘时间以及市场状态。
• bond_data：用于获取特定债券的详细信息，如发行详情和收益率。
• search_bonds：允许按类型、到期日和其他标准搜索或过滤债券。

环境变量

项目结构

Treasury-Direct-MCP-Server
├── src/
│   ├── market_data.js       # 处理市场数据的模块
│   ├── bond_data.js         # 获取债券详细信息的模块
│   └── search_bonds.js     # 搜索和过滤债券的模块
├── package.json           # 项目依赖和脚本配置
└── LICENSE                # 许可证文件

可用脚本

📄 许可证

该项目使用 GNU Affero General Public License v3.0 许可证，详情请参阅 LICENSE 文件。

🤝 贡献

欢迎贡献！请访问 GitHub 查看如何参与。