交易模拟器MCP服务器

一个用于与交易模拟器API交互的MCP服务器,支持AI模型通过MCP兼容接口查询余额、价格和执行交易。

  • by recallnet
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 recallnet/trading-simulator-mcp

使用说明

交易模拟器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密钥具有执行交易的完全访问权限,因此相应地保护它