Tesouro Direto MCP

🚀 財政直投 MCP サーバー

このサーバーは、Tesouro Direto API と統合するための Model Context Protocol (MCP) サーバーの実装です。MCP 互換クライアントを通じて、ブラジル国債データに自然言語でアクセスできます。

✨ 主な機能

日常言語を使って、市場データや債券の詳細情報を照会し、種類、満期日などの基準で債券を検索/フィルタリングすることができます。

• MCP ツール：
  • market_data：一般的な国債市場データ（開場/閉場時間、状態）を取得します。
  • bond_data：特定の債券の詳細情報を取得します。
  • search_bonds：種類、満期日、その他の基準で債券を検索/フィルタリングします。
• スマートキャッシュ：API の更新タイムスタンプに基づく 10 分間のメモリキャッシュを使用して、呼び出し回数を減らし、データの新鮮さを確保します。

💻 使用例

基本的な使用法

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

• "すべての利用可能な財政直投債券を表示してください"
• "IPCA+2029 債券の詳細情報を取得してください"
• "2045 年以降に満期の IPCA 債券を検索してください"
• "現在の国債市場の状態はどうですか？"
• "収益率が最も高い上位 3 種類の債券（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

📚 ドキュメント

MCP ツールの詳細

• market_data：一般的な国債市場データを取得します。これには、開場時間、閉場時間、市場の状態が含まれます。
• bond_data：特定の債券の詳細情報を取得します。これには、発行詳細や収益率が含まれます。
• search_bonds：種類、満期日、その他の基準で債券を検索またはフィルタリングします。

環境変数

プロジェクト構造

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 ファイルを参照してください。