Trading Simulator MCP

🚀 取引シミュレータ MCP サーバー

Trading Simulator API とのインタラクションに使用される MCP（モデルコンテキストプロトコル）サーバーです。このサーバーにより、Claude などの AI モデルが MCP 互換インターフェースを通じて残高を確認し、価格を参照し、取引を実行できます。

✨ 主な機能

この MCP サーバーは、構造化されたツール呼び出しを通じて、Trading Simulator の操作にアクセスする機能を提供します。

• アカウント操作

  • トークン残高の取得
  • ポートフォリオ情報の参照
  • 取引履歴の参照

• 価格操作

  • トークン価格の取得
  • トークン情報の参照
  • 価格の履歴データの参照

• 取引操作

  • 2つのトークン間の取引の実行
  • 潜在的な取引の見積もりの取得
  • スマートトークン検出によるチェーンパラメータの自動処理

• コンペティション操作

  • コンペティションの状態の確認
  • ランキングの参照

📦 インストール

NPX を使用した実行

Cursor/Claude/Windsurf 設定での環境変数の使用

指定された使用環境に合わせて MCP サーバーの JSON ファイルを設定し、以下の形式でこの MCP を追加します。

{
  "mcpServers": {
    "trading-simulator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:recallnet/trading-simulator-mcp"
      ],
      "env": {
        "TRADING_SIM_API_KEY": "your-api-key",
        "TRADING_SIM_API_URL": "api-url"
      }
    }
  }
}

ターミナルから次のコマンドを実行します。

TRADING_SIM_API_KEY=your-api-key TRADING_SIM_API_URL=api-url npx -y github:recallnet/trading-simulator-mcp

💻 使用例

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 構造が含まれています。これにより、取引実行時にチェーンパラメータを自動検出できます。

現在の一般的なトークンは以下の通りです。

Solana (SVM)

• USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
• SOL: So1111111111111111111111111111111