交易模拟器 MCP 服务器

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

特征

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

• 账户操作

  • 获取代币余额

  • 获取投资组合信息

  • 查看交易历史记录

• 价格操作

  • 获取代币价格

  • 获取代币信息

  • 查看价格历史记录

• 交易业务

  • 执行代币之间的交易

  • 获取潜在交易的报价

  • 智能代币检测，自动处理链参数

• 竞赛运营

  • 查看比赛状态

  • 查看排行榜

智能令牌处理

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

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

• 同链优化：同链交易Token时，自动配置同链交易参数。

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

• 常见代币支持：系统包含不断增长的常见代币列表及其地址和链信息。

验证

交易模拟器 API 使用 Bearer 令牌身份验证，需要在Authorization标头中传递单个 API 密钥作为 Bearer 令牌。

例子：

设置

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

配置

您有两种配置交易模拟器 MCP 服务器的选项：

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

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

• 当通过配置提供这些环境变量时，服务器将自动使用这些环境变量。

• 有关具体设置说明，请参阅下面的“添加到光标”和“添加到 Claude 桌面”部分。

方法 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

环境变量优先级

交易模拟器 MCP 服务器对环境变量使用以下优先顺序：

1. 直接从 JSON 配置提供的环境变量

2. .env 文件中的环境变量（如果存在且 #1 不可用）

3. 可选变量的默认值（例如，API_URL 默认为“ http://localhost:3000 ”）

添加到光标

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

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

2. 在 Cursor 中，前往“设置”>“MCP 服务器”

3. 点击“添加服务器”

4. 使用以下设置配置服务器：

   • 名称： Trading Simulator MCP （或您喜欢的任何名称）

   • 类型： command

   • 命令： node

   • 参数： /path/to/trading-sim-mcp/dist/index.js （使用完整路径）

   • 环境变量：

     • TRADING_SIM_API_KEY ：您的 API 密钥

     • TRADING_SIM_API_URL ：API 服务器 URL（可选）

     • DEBUG ： true （可选，用于附加日志记录）

5. 点击“保存”

在游标配置中使用环境变量

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

这种方法消除了对 .env 文件的需要。

添加到 Claude 桌面

要将此 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 桌面应用和 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结构，用于将代币地址映射到其各自的链上。这使得在执行交易时能够自动检测链上的参数。

目前常见的代币包括：

索拉纳（SVM）

• USDC： EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

• SOL: So11111111111111111111111111111111111111112

以太坊（EVM）

• USDC： 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

• WETH： 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

基础（EVM）

• USDC： 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

• 以太坊： 0x4200000000000000000000000000000000000006

要添加更多常见的标记，您可以扩展types.ts文件中的COMMON_TOKENS对象。

安全注意事项

• 您的 API 密钥应保持安全，并且绝不要在客户端代码中共享或暴露

• 在生产环境中连接 API 时始终使用 HTTPS

• API 密钥具有执行交易的完全访问权限，因此请妥善保护它