交易模拟器 MCP 服务器

一个用于与 Trading Simulator API 交互的 MCP（模型上下文协议）服务器。此服务器使像 Claude 这样的 AI 模型能够通过兼容 MCP 的接口检查余额、查看价格并执行交易。

特性

此 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 工具

该服务器提供了以下 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