Tradovate MCP Server

Tradovate MCP サーバー

Tradovate API と連携するための Model Context Protocol（MCP）サーバーです。このサーバーは、Tradovate の契約、ポジション、注文、口座を管理するためのツールを提供します。

特長

• Tradovate API での認証
• キャッシュを利用したリアルタイムデータの取得
• 契約の詳細、ポジション管理、注文発注などのツール
• API が利用できない場合はシミュレーションデータにフォールバック

インストール

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

npm install

3. Tradovate の認証情報を含む .env ファイルを作成します：

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 Inspector と一緒に使用します：

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 - 市場データ（気配値、DOM、チャート）を取得します

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/getDOM - マーケットデプスデータを取得します
• /md/getChart - チャートデータを取得します

ライセンス

MIT ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。