トレーディングシミュレーター MCP サーバー

トレーディングシミュレーターAPIと連携するためのMCP（モデルコンテキストプロトコル）サーバー。このサーバーにより、ClaudeのようなAIモデルは、MCP互換インターフェースを介して残高や価格を確認し、取引を実行できるようになります。

特徴

この MCP サーバーは、構造化されたツール呼び出しを通じてトレーディング シミュレーター操作へのアクセスを提供します。

• アカウント操作
  • トークン残高を取得する
  • ポートフォリオ情報を取得する
  • 取引履歴を表示
• 価格操作
  • トークンの価格を取得する
  • トークン情報を取得する
  • 価格履歴を見る
• 取引業務
  • トークン間の取引を実行する
  • 潜在的な取引の見積もりを取得する
  • チェーンパラメータを自動的に処理するスマートトークン検出
• 競技運営
  • 競技状況を確認する
  • リーダーボードランキングを見る

スマートトークン処理

トレーディング シミュレーター MCP には、取引の実行を簡素化するインテリジェントなトークン検出システムが含まれています。

• 自動チェーン検出: 一般的なトークンで取引を実行する場合、システムは適切なブロックチェーン (EVM/SVM) と特定のチェーン (ETH、BASE など) のパラメータを自動的に識別します。
• 同一チェーンの最適化: 同じチェーン上でトークンを取引する場合、同一チェーン取引のパラメータが自動的に設定されます。
• クロスチェーンフォールバック: トークンが異なるチェーン上にあるために同じチェーンの取引が失敗した場合、システムは明示的なパラメータまたはサーバー側の検出に適切にフォールバックします。
• 共通トークンのサポート: システムには、アドレスとチェーン情報を含む共通トークンのリストが含まれます。

認証

Trading Simulator API は Bearer トークン認証を使用するため、Bearer トークンとしてAuthorizationヘッダーに渡される単一の API キーが必要です。

例：

設定

1. リポジトリをクローンする
   git clone https://github.com/yourusername/trading-simulator-mcp.git cd trading-simulator-mcp
2. 依存関係をインストールする
   npm install
3. API 資格情報を設定します (以下の設定セクションを参照)
4. プロジェクトを構築する
   npm run build
5. サーバーを起動する
   npm run start

構成

Trading Simulator MCP サーバーを構成するには、次の 2 つのオプションがあります。

方法 1: Cursor/Claude での直接設定 (推奨)

推奨される方法は、Cursor または Claude Desktop の設定で環境変数を直接指定することです。これによりセキュリティが向上し、.env ファイルが不要になります。

• 構成を通じて提供される場合、サーバーはこれらの環境変数を自動的に使用します。
• 具体的なセットアップ手順については、以下の「カーソルへの追加」および「Claude デスクトップへの追加」セクションを参照してください。

方法2: .env ファイルを使用する（フォールバック）

.env ファイルを使用する場合、またはコマンド ラインから直接サーバーを実行する場合:

1. API認証情報を含む.envファイルを作成する
   cp .env.example .env
2. APIキーを使用して.envファイルを編集します
   TRADING_SIM_API_KEY=your_api_key_here TRADING_SIM_API_URL=http://localhost:3000 DEBUG=false
3. 制限された権限で.envファイルを保護する
   chmod 600 .env

環境変数の優先順位

Trading Simulator MCP サーバーは、環境変数に対して次の優先順位を使用します。

1. JSON 構成から直接提供される環境変数
2. .env ファイルからの環境変数（存在し、#1 が利用できない場合）
3. オプション変数のデフォルト値（例：API_URL のデフォルトは " http://localhost:3000 "）

カーソルに追加

この MCP サーバーをカーソルに追加するには:

1. まずnpm run buildでプロジェクトをビルドします。
2. カーソルで、「設定」>「MCPサーバー」に移動します。
3. 「サーバーを追加」をクリックします
4. 次の設定でサーバーを構成します。
   • 名前: Trading Simulator MCP (または任意の名前)
   • タイプ: command
   • コマンド: node
   • 引数: /path/to/trading-sim-mcp/dist/index.js (フルパスを使用)
   • 環境変数:
     • TRADING_SIM_API_KEY : APIキー
     • TRADING_SIM_API_URL : APIサーバーのURL（オプション）
     • DEBUG : true (オプション、追加のログ記録用)
5. 「保存」をクリック

カーソル設定における環境変数の使用

セキュリティを強化するには、ホーム ディレクトリの.cursor/mcp.jsonファイルを使用して Cursor を設定できます。

このアプローチにより、.env ファイルが不要になります。

Claudeデスクトップに追加

この MCP サーバーを Claude Desktop に追加するには:

1. まずnpm run buildでプロジェクトをビルドします。
2. Claude Desktop 構成ファイルを次の場所に移動します。
   • macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows の場合: %APPDATA%\Claude\claude_desktop_config.json
   • Linuxの場合: ~/.config/Claude/claude_desktop_config.json
3. 次の内容でclaude_desktop_config.jsonファイルを作成または編集します。
   { "mcpServers": { "trading-simulator-mcp": { "name": "Trading Simulator MCP", "type": "command", "command": "node", "args": [ "/path/to/trading-simulator-mcp/dist/index.js" ], "env": { "TRADING_SIM_API_KEY": "your_api_key_here", "TRADING_SIM_API_URL": "http://localhost:3000", "DEBUG": "true" } } } }
4. /path/to/trading-simulator-mcp/dist/index.jsをコンパイルしたサーバーファイルへのフルパスに置き換えます。
   • 例: /Users/username/trading-simulator-mcp/dist/index.js
5. 設定ファイルを保存し、Claude Desktopを再起動します。

Claude Desktop で問題が発生した場合は、次のログを確認してください。

• macOSの場合: ~/Library/Logs/Claude/
• Windows の場合: %USERPROFILE%\AppData\Local\Claude\Logs\
• Linuxの場合: ~/.local/share/Claude/logs/

重要な開発ノート

MCPサーバーを開発する際は、デバッグとログ出力にconsole.error()ではなくconsole.log()を使用してください。Claude DesktopアプリとCursorはstdout経由でサーバーと通信するため、 console.log()ステートメントは通信を妨害し、JSON解析エラーを引き起こします。

MCPツール

サーバーは次の MCP ツールを提供します。

アカウントツール

• get_balances - チームのトークン残高を取得する
• get_portfolio - チームのポートフォリオ情報を取得する
• get_trades - チームのトレード履歴を取得する

価格ツール

• get_price - トークンの現在の価格を取得する
• get_token_info - トークンの詳細情報を取得する
• get_price_history - トークンの過去の価格データを取得する

取引ツール

• execute_trade - 2つのトークン間の取引を実行する
  • 一般的なトークンのチェーンパラメータを自動的に検出して割り当てます
  • 明示的なチェーンパラメータを必要とせずに同一チェーン取引をサポート
  • クロスチェーンシナリオに適切にフォールバックします
• get_quote - 潜在的な取引の見積もりを取得する

競争ツール

• get_competition_status - 現在の競争のステータスを取得します
• get_leaderboard - 競争のリーダーボードを取得する

共通トークン

システムには、トークンアドレスをそれぞれのチェーンにマッピングするCOMMON_TOKENS構造体が含まれています。これにより、取引実行時にチェーンパラメータの自動検出が可能になります。

現在一般的なトークンには以下のものがあります:

ソラナ（SVM）

• USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
• ソル: So11111111111111111111111111111111111111112

イーサリアム（EVM）

• USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• ウェス: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

ベース（EVM）

• USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• ETH: 0x4200000000000000000000000000000000000006

より一般的なトークンを追加するには、 types.tsファイル内のCOMMON_TOKENSオブジェクトを拡張できます。

セキュリティに関する考慮事項

• APIキーは安全に保管し、クライアント側のコードで共有したり公開したりしないでください。
• 本番環境でAPIに接続するときは常にHTTPSを使用する
• APIキーは取引を実行するための完全なアクセス権を持っているため、それに応じて保護してください。