Trading Simulator MCP Server

交易模拟器MCP服务器

用于与交易模拟器API交互的MCP（模型上下文协议）服务器。该服务器使Claude等AI模型能够通过MCP兼容的界面检查余额、检查价格和执行交易。

特性

此MCP服务器通过结构化工具调用提供对交易模拟器操作的访问：

• 账户操作

- 获取代币余额 - 获取投资组合信息 - 查看交易历史记录

• 价格操作

- 获取代币价格 - 获取令牌信息 - 查看价格历史记录

• 交易操作

- 执行代币之间的交易 - 获取潜在交易的报价 - 自动处理链参数的智能令牌检测

• 竞争运营

- 检查比赛状态 - 查看排行榜排名

使用NPX

在Cursor/Claude/Windsurf配置中使用环境变量

通过使用以下格式添加此MCP，为您的指定消费环境配置MCP服务器JSON文件：

{
  "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 将令牌地址映射到其各自链的结构。这使得在执行交易时能够自动检测链参数。

目前常见的代币包括：

索拉纳（SVM）

• USDC： EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
• 溶胶： So11111111111111111111111111111111111111112

以太坊（EVM）

• USDC： 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• WETH： 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

基础（EVM）

• USDC： 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• ETH： 0x4200000000000000000000000000000000000006

要添加更多常见令牌，您可以扩展 COMMON_TOKENS 对象在 types.ts 文件。

安全考虑

• 您的API密钥应保持安全，不得在客户端代码中共享或公开
• 在生产环境中连接到API时始终使用HTTPS
• API密钥具有执行交易的完全访问权限，因此相应地保护它