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

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

特徴

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

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

Related MCP server: Database Tools for Claude AI

スマートトークン処理

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

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

認証

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

例：

Authorization: Bearer your_api_key_here

設定

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

構成

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

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

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

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

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

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

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

環境変数の優先順位

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

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

カーソルに追加

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

まずnpm run buildでプロジェクトをビルドします。
カーソルで、「設定」>「MCPサーバー」に移動します。
「サーバーを追加」をクリックします
次の設定でサーバーを構成します。
- 名前: 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 (オプション、追加のログ記録用)
「保存」をクリック

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

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

{ "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" } } } }

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

Claudeデスクトップに追加

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

まずnpm run buildでプロジェクトをビルドします。
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
次の内容で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" } } } }
/path/to/trading-simulator-mcp/dist/index.jsをコンパイルしたサーバーファイルへのフルパスに置き換えます。
- 例: /Users/username/trading-simulator-mcp/dist/index.js
設定ファイルを保存し、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キーは取引を実行するための完全なアクセス権を持っているため、それに応じて保護してください。

Trading Simulator MCP Server