Tesouro Direto MCP Server

Tesouro Direto MCP サーバー

Tesouro Direto API と連携する Model Context Protocol（MCP）サーバーの実装です。自然言語でブラジル国債のデータにアクセスできます。

---

機能

MCP 互換クライアントを通じて、日常的な言葉で市場データや債券の詳細を取得したり、債券を検索・絞り込みしたりできます。

• MCP ツール：
  • market_data：国債市場の全般的なデータ（取引開始・終了時刻、ステータス）を取得します
  • bond_data：特定の債券の詳細情報を取得します
  • search_bonds：種類、満期などの条件で債券を検索・絞り込みします
• スマートキャッシュ：API の更新タイムスタンプに基づく10分間のインメモリーキャッシュにより、データの鮮度を保ちながら API 呼び出しを削減します。

---

使用例

MCP 互換クライアントでは、次のようなプロンプトを使用できます。

• 「利用可能な Tesouro Direto 債券をすべて表示して」
• 「IPCA+ 2029 債券の詳細を取得して」
• 「2045年以降に満期を迎える IPCA 債券を検索して」
• 「現在の国債市場のステータスは？」
• 「IPCA 債券と固定金利債券それぞれについて、利回りの高い上位3銘柄を詳しく分析して」

---

インストール

Smithery 経由でのインストール

Smithery 経由で、Claude Desktop 用の Tesouro Direto MCP サーバーを自動的にインストールするには：

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

npm 経由でのインストール

MCP クライアント（Cursor/Claude）の設定用 JSON の例

npx を使って、~/.cursor/mcp.json に以下を追加します。デスクトップアプリを使用している場合は、claude_desktop_config.json に追加してください。

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

---

ソースからビルドする

# Clone the repository
git clone https://github.com/AtilioA/tesouro-direto-mcp.git
cd tesouro-direto-mcp

# Install dependencies
pnpm install

# Build the project
pnpm run build

ビルド後、MCP サーバーを直接実行できます。

node dist/index.js

または、MCP Inspector などの MCP 互換クライアントで使用できます。

npx @modelcontextprotocol/inspector dist/index.js

---

ツール

market_data

取引開始・終了時刻や現在のステータスなど、市場の全般的なデータを取得します。

bond_data

コードを指定して、特定の債券の詳細情報を取得します。

search_bonds

種類（SELIC、IPCA、PREFIXADO）、満期日などの条件で債券を検索・絞り込みします。

---

環境変数

Variable	Description	Default
USE_MCP_CACHE	API レスポンスのインメモリーキャッシュを有効にします	true

環境または MCP クライアントの設定で、これらを指定してください。

---

プロジェクト構成

src/
├── api/         # API client for Tesouro Direto
│   └── tesouroDireto.ts
├── cache/       # Caching implementation
│   └── apiCache.ts
├── resources/   # MCP resources implementation
│   └── index.ts
├── tools/       # MCP tools implementation
│   ├── bondData.ts
│   ├── marketData.ts
│   └── searchBonds.ts
├── types/       # Type definitions
│   └── index.ts
├── utils/       # Utility functions
│   ├── errorHandler.ts
│   └── logger.ts
├── client.ts    # Example MCP client
├── index.ts     # Entry point
└── server.ts    # MCP server implementation

---

利用可能なスクリプト

• pnpm run build / npm run build：プロジェクトをビルドします
• pnpm start / npm start：サーバーを起動します
• pnpm run dev / npm run dev：自動リロードを有効にして、開発モードでサーバーを起動します

---

貢献

貢献を歓迎します。GitHub でイシューを作成するか、プルリクエストを送信してください。

---

ライセンス

このプロジェクトは GNU Affero General Public License v3.0 の下でライセンスされています。詳しくは LICENSE ファイルをご覧ください。