Tradovate MCP Server

🚀 Tradovate MCP サーバー

このサーバーは、Tradovate APIとのインタラクションを可能にするモデルコンテキストプロトコル（MCP）サーバーです。管理用のコントラクト、ポジション、注文、アカウントのツールを提供します。

🚀 クイックスタート

このサーバーを使用することで、Tradovate APIとのやり取りをスムーズに行うことができます。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• Tradovate APIとの認証機能
• キャッシュを利用したリアルタイムデータ取得
• コントラクト詳細、ポジション管理、注文の発行や変更などのツール
• APIが利用できない場合には、模擬データにフォールバック

📦 インストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

npm install

3. .envファイルを作成し、あなたのTradovateの認証情報を追加します。

TRADOVATE_API_ENVIRONMENT=demo
TRADOVATE_USERNAME=your_username
TRADOVATE_PASSWORD=your_password
TRADOVATE_APP_ID=Sample App
TRADOVATE_APP_VERSION=1.0
TRADOVATE_CID=your_cid
TRADOVATE_SEC=your_sec

💻 使用例

基本的な使用法

サーバーを起動します。

npm start

高度な使用法

MCPインスペクターと一緒に使用する場合。

npm run inspector

📚 ドキュメント

プロジェクト構造

• src/index.ts - メインサーバーのエントリーポイント
• src/auth.ts - 認証関数
• src/data.ts - データ取得とキャッシュ
• src/tools.ts - MCPツールのハンドラー
• src/types.ts - TypeScriptの型定義
• tests/ - テストファイル

ビルド

npm run build

テスト

テストを実行します。

npm test

カバレッジ付きでテストを実行します。

npm run test:coverage

カバレッジバッジを生成します。

npm run coverage:badge

利用可能なツール

サーバーは以下のツールを提供します。

1. get_contract_details - シンボルに基づいて特定のコントラクトの詳細を取得
2. list_positions - アカウントのポジションリストを取得
3. place_order - 新しい注文を発行
4. modify_order - 既存の注文を変更
5. cancel_order - 既存の注文をキャンセル
6. liquidate_position - ポジションを決済
7. get_account_summary - アカウントの概要情報を取得
8. get_market_data - 市場データ（価格、板情報）を取得

APIエンドポイント

サーバーは以下のTradovate APIエンドポイントとやり取りします。

認証

• /auth/accessTokenRequest - アクセストークンを取得
• /auth/renewAccessToken - アクセストークンを更新

コントラクト

• /contract/list - すべてのコントラクトをリスト表示
• /contract/find - 特定のコントラクトを検索

ポジション

• /position/list - すべてのポジションをリスト表示

注文

• /order/list - すべての注文をリスト表示
• /order/placeOrder - 新しい注文を発行
• /order/modifyOrder - 既存の注文を変更
• /order/cancelOrder - 既存の注文をキャンセル
• /order/liquidatePosition - ポジションを決済

アカウント

• /account/list - すべてのアカウントをリスト表示
• /account/find - 特定のアカウントを検索
• /cashBalance/getCashBalanceSnapshot - アカウントの現金残高のスナップショットを取得

市場データ

• /md/getQuote - 価格データを取得
• /md/get - 市場の板情報を取得
• /md/getChart - チャートデータを取得

📄 ライセンス

MIT License