Trading Simulator MCP

🚀 交易模擬器 MCP 服務器

交易模擬器 MCP 服務器是一個用於與 Trading Simulator API 交互的 MCP（模型上下文協議）服務器。它能讓像 Claude 這樣的 AI 模型，通過兼容 MCP 的接口檢查餘額、查看價格並執行交易，為 AI 參與交易模擬提供了便利。

✨ 主要特性

此 MCP 服務器提供了訪問 Trading Simulator 操作的功能，通過結構化的工具調用，具備以下特性：

• 賬戶操作

  • 獲取代幣餘額，方便了解賬戶資產狀況。
  • 查看投資組合信息，掌握資產配置情況。
  • 查看交易歷史記錄，回顧交易行為。

• 價格操作

  • 獲取代幣價格，即時瞭解市場行情。
  • 查看代幣信息，深入瞭解代幣詳情。
  • 查看價格歷史數據，分析價格走勢。

• 交易操作

  • 執行兩個代幣之間的交易，實現資產轉換。
  • 獲取潛在交易的報價，提前瞭解交易成本。
  • 智能代幣檢測，自動處理鏈參數，簡化交易流程。

• 競賽操作

  • 檢查競賽狀態，掌握競賽進度。
  • 查看排行榜排名，瞭解自身在競賽中的位置。

📦 安裝指南

使用 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 工具，以下是部分工具的使用示例：

賬戶工具

# 獲取團隊的代幣餘額
get_balances()

# 獲取團隊的投資組合信息
get_portfolio()

# 查看團隊的交易歷史記錄
get_trades()

價格工具

# 獲取某個代幣的當前價格
get_price()

# 獲取某個代幣的詳細信息
get_token_info()

# 獲取某個代幣的歷史價格數據
get_price_history()

交易工具

# 執行兩個代幣之間的交易
execute_trade()

# 獲取潛在交易的報價
get_quote()

競賽工具

# 獲取當前競賽的狀態
get_competition_status()

# 查看競賽排行榜
get_leaderboard()

📚 詳細文檔

MCP 工具

該服務器提供了以下 MCP 工具：

賬戶工具

• get_balances - 獲取團隊的代幣餘額
• get_portfolio - 獲取團隊的投資組合信息
• get_trades - 查看團隊的交易歷史記錄

價格工具

• get_price - 獲取某個代幣的當前價格
• get_token_info - 獲取某個代幣的詳細信息
• get_price_history - 獲取某個代幣的歷史價格數據

交易工具

• execute_trade - 執行兩個代幣之間的交易
  • 自動檢測並分配常見代幣的鏈參數
  • 支持在同一鏈上進行交易，無需顯式指定鏈參數
  • 在跨鏈場景中優雅降回
• get_quote - 獲取潛在交易的報價

競賽工具

• get_competition_status - 獲取當前競賽的狀態
• get_leaderboard - 查看競賽排行榜

常見代幣

系統包含一個映射代幣地址到其相應鏈的 COMMON_TOKENS 結構。這使得在執行交易時能夠自動檢測鏈參數。

當前常見代幣包括：

Solana (SVM)

• USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
• SOL: So1111111111111111111111111111111