资产直接MCP服务器

这是一个用于与资产直接API集成的模型上下文协议（MCP）服务器实现，使用户能够通过自然语言访问巴西国债数据。

---

功能

通过MCP兼容客户端使用日常语言查询市场数据、债券详情，并搜索/筛选债券。

• MCP工具：
  • market_data：获取一般国债市场数据（开盘/收盘时间，状态）
  • bond_data：获取特定债券的详细信息
  • search_bonds：按类型、到期日和其他标准搜索/筛选债券
• 智能缓存：基于API更新时间戳的10分钟内存缓存，以减少调用次数同时确保数据新鲜度。

---

示例用法

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

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

---

安装

通过Smithery安装

要通过Smithery自动安装资产直接MCP服务器到Claude桌面：

npx -y @smithery/cli install @AtilioA/tesouro-direto-mcp --client claude

通过npm安装

示例JSON用于MCP客户端配置（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服务器：

node dist/index.js

或者与任何MCP兼容客户端一起使用（例如，MCP Inspector）：

npx @modelcontextprotocol/inspector dist/index.js

---

工具

market_data

获取包括开盘/收盘时间和当前状态的一般市场数据。

bond_data

通过其代码获取特定债券的详细信息。

search_bonds

按类型（SELIC，IPCA，PREFIXADO），到期日等搜索和筛选债券。

---

环境变量

变量	描述	默认值
USE_MCP_CACHE	启用API响应的内存缓存	true

在您的环境或MCP客户端配置中设置这些变量。

---

项目结构

src/
├── api/         # 资产直接API客户端
│   └── tesouroDireto.ts
├── cache/       # 缓存实现
│   └── apiCache.ts
├── resources/   # MCP资源实现
│   └── index.ts
├── tools/       # MCP工具实现
│   ├── bondData.ts
│   ├── marketData.ts
│   └── searchBonds.ts
├── types/       # 类型定义
│   └── index.ts
├── utils/       # 实用函数
│   ├── errorHandler.ts
│   └── logger.ts
├── client.ts    # 示例MCP客户端
├── index.ts     # 入口点
└── server.ts    # MCP服务器实现

---

可用脚本

• pnpm run build / npm run build：构建项目
• pnpm start / npm start`：启动服务器
• pnpm run dev / npm run dev：以开发模式启动服务器并自动重载

---

贡献

欢迎贡献！请在GitHub上打开问题或提交拉取请求。

---

许可证

本项目根据GNU Affero通用公共许可证v3.0授权。详情见LICENSE文件。