Trading Simulator MCP 服务器

一个用于与 Trading Simulator API 交互的 MCP (模型上下文协议) 服务器。该服务器使像 Claude 这样的人工智能模型能够通过 MCP 兼容的接口检查余额、检查价格和执行交易。

功能

此 MCP 服务器通过结构化的工具调用提供对 Trading Simulator 操作的访问：

• 账户操作

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

• 价格操作

  • 获取代币价格
  • 获取代币信息
  • 查看价格历史

• 交易操作

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

• 竞赛操作

  • 检查竞赛状态
  • 查看排行榜排名

智能代币处理

Trading Simulator MCP 包含一个智能代币检测系统，可简化交易执行：

• 自动链检测：当使用常用代币执行交易时，系统会自动识别适当的区块链 (EVM/SVM) 和特定链 (ETH, BASE 等) 参数。

• 同链优化：当在同一链上交易代币时，参数会自动配置为同链交易。

• 跨链回退：如果由于代币位于不同的链上而导致同链交易失败，系统会优雅地回退到显式参数或服务器端检测。

• 常用代币支持：该系统包含一个不断增长的常用代币列表，其中包含它们的地址和链信息。

身份验证

Trading Simulator API 使用 Bearer token 身份验证，需要在 Authorization 标头中传递单个 API 密钥作为 Bearer token。

示例：

Authorization: Bearer your_api_key_here

设置

1. 克隆存储库

   git clone https://github.com/yourusername/trading-simulator-mcp.git
   cd trading-simulator-mcp
   

2. 安装依赖项

   npm install
   

3. 配置您的 API 凭据（请参阅下面的配置部分）

4. 构建项目

   npm run build
   

5. 启动服务器

   npm run start
   

配置

您有两种配置 Trading Simulator MCP 服务器的选项：

方法 1：在 Cursor/Claude 中直接配置（推荐）

推荐的方法是直接在您的 Cursor 或 Claude Desktop 配置中提供环境变量。 这样更安全，并且无需 .env 文件。

• 当通过配置提供这些环境变量时，服务器将自动使用它们。
• 有关具体的设置说明，请参阅下面的“添加到 Cursor”和“添加到 Claude Desktop”部分。

方法 2：使用 .env 文件（备用）

如果您更喜欢使用 .env 文件，或者直接从命令行运行服务器：

1. 创建一个包含您的 API 凭据的 .env 文件

   cp .env.example .env
   

2. 使用您的 API 密钥编辑 .env 文件

   TRADING_SIM_API_KEY=your_api_key_here
   TRADING_SIM_API_URL=http://localhost:3000
   DEBUG=false
   

3. 使用受限权限保护您的 .env 文件

   chmod 600 .env
   

环境变量优先级

Trading Simulator MCP 服务器使用以下环境变量优先级顺序：

1. 直接从 JSON 配置提供的环境变量
2. 来自 .env 文件的环境变量（如果存在且 #1 不可用）
3. 可选变量的默认值（例如，API_URL 默认为 "http://localhost:3000"）

添加到 Cursor

要将此 MCP 服务器添加到 Cursor：

1. 首先使用 npm run build 构建项目
2. 在 Cursor 中，转到 Settings > MCP Servers
3. 单击“Add Server”
4. 使用以下设置配置服务器：
   • Name: Trading Simulator MCP（或您喜欢的任何名称）
   • Type: command
   • Command: node
   • Arguments: /path/to/trading-sim-mcp/dist/index.js（使用完整路径）
   • Environment Variables:
     • TRADING_SIM_API_KEY: 您的 API 密钥
     • TRADING_SIM_API_URL: API 服务器 URL（可选）
     • DEBUG: true（可选，用于额外的日志记录）
5. 单击“Save”

在 Cursor 配置中使用环境变量

为了更高的安全性，您可以通过主目录中的 .cursor/mcp.json 文件配置 Cursor：

{
  "mcpServers": {
    "trading-simulator-mcp": {
      "name": "Trading Simulator MCP",
      "type": "command",
      "command": "node",
      "args": ["/path/to/trading-simulator-mcp/dist/index.js"],
      "env": {
        "TRADING_SIM_API_KEY": "your_api_key_here",
        "TRADING_SIM_API_URL": "http://localhost:3000",
        "DEBUG": "true"
      }
    }
  }
}

这种方法无需 .env 文件。

添加到 Claude Desktop

要将此 MCP 服务器添加到 Claude Desktop：

1. 首先使用 npm run build 构建项目

2. 找到您的 Claude Desktop 配置文件，位于：

   • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json
   • 在 Linux 上：~/.config/Claude/claude_desktop_config.json

3. 创建或编辑 claude_desktop_config.json 文件，内容如下：

   {
     "mcpServers": {
       "trading-simulator-mcp": {
         "name": "Trading Simulator MCP",
         "type": "command",
         "command": "node",
         "args": [
           "/path/to/trading-simulator-mcp/dist/index.js"
         ],
         "env": {
           "TRADING_SIM_API_KEY": "your_api_key_here",
           "TRADING_SIM_API_URL": "http://localhost:3000",
           "DEBUG": "true"
         }
       }
     }
   }
   

4. 将 /path/to/trading-simulator-mcp/dist/index.js 替换为已编译服务器文件的完整路径

   • 示例：/Users/username/trading-simulator-mcp/dist/index.js

5. 保存配置文件并重新启动 Claude Desktop

如果您在使用 Claude Desktop 时遇到问题，请检查以下位置的日志：

• 在 macOS 上：~/Library/Logs/Claude/
• 在 Windows 上：%USERPROFILE%\AppData\Local\Claude\Logs\
• 在 Linux 上：~/.local/share/Claude/logs/

重要的开发说明

在开发 MCP 服务器时，请使用 console.error() 而不是 console.log() 进行所有调试和日志记录。 Claude Desktop 应用程序和 Cursor 通过 stdout 与服务器通信，因此任何 console.log() 语句都会干扰此通信并导致 JSON 解析错误。

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: So11111111111111111111111111111111111111112

Ethereum (EVM)

• USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• WETH: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

Base (EVM)

• USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• ETH: 0x4200000000000000000000000000000000000006

要添加更多常用代币，您可以在 types.ts 文件中扩展 COMMON_TOKENS 对象。

安全注意事项

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