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 文件。