Alexanimal 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/accessToken - アクセストークンを取得します。
• /auth/refreshToken - アクセストークンを更新します。

契約関連

• /contracts - すべての契約情報を取得します。
• /contracts/{id} - 特定の契約の詳細情報を取得します。

ポジション管理

• /positions - すべてのポジションを一覧表示します。
• /positions/{id} - 特定のポジションの情報を取得します。

注文処理

• /orders - 新しい注文を発行するか、すべての注文を一覧表示します。
• /orders/{id} - 特定の注文を取得またはキャンセルします。
• /orderBook - 注文板情報を取得します。

アカウント関連

• /accounts - すべてのアカウント情報を一覧表示します。
• /balances - 資金残高を照会します。
• /transfers - 資金の振り替えを処理します。

市場データ

• /quotes - リアルタイムの相場データを取得します。
• /candles - 過去のローソク足データを取得します。
• /marketDEPTH - 市場の板情報を表示します。

📄 ライセンス

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