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