Tesouro Direto MCP

🚀 财政直投 MCP 服务器

这是一个用于与 Tesouro Direto API 集成的 Model Context Protocol (MCP) 服务器实现，借助 MCP 兼容客户端，能让用户以自然语言的方式访问巴西国债数据，为国债数据查询提供了便捷途径。

🚀 快速开始

本服务器可通过 MCP 兼容客户端，让用户用自然语言访问巴西国债数据。你只需在客户端输入日常语言的查询，就能获取市场数据、债券详细信息等。

✨ 主要特性

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

💻 使用示例

基础用法

在 MCP 兼容客户端中，你可以使用以下提示进行查询：

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

📦 安装指南

通过 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

📚 详细文档

工具说明

环境变量

项目结构

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

可用脚本

🤝 贡献

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

📄 许可证

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