使用说明

项目简介

TransactionSimulatorMCP 是一个基于 Model Context Protocol (MCP) 构建的后端服务器，专注于以太坊交易的AI分析和模拟。它利用 Tenderly 进行实时的交易模拟，并结合 OpenAI 或 Google Gemini 的 AI 模型生成人性化的交易分析报告。用户可以通过向 MCP 客户端（如 Cursor 或 Claude Desktop）发送交易参数，获取该交易在以太坊网络上的潜在影响、Token 余额变化、Gas 消耗等详细分析，从而更好地理解交易内容并评估其安全性。

主要功能点

实时交易模拟: 使用 Tenderly 平台在所有以太坊兼容网络上模拟交易执行。
AI 智能解读: 集成 OpenAI 和 Google Gemini 模型，将复杂的交易结果转化为人类可读的分析报告。
广泛网络支持: 支持所有以太坊兼容网络，适用性强。
详细交易分析: 深入分析 ERC20、ERC721 和 ERC1155 Token 的转移、合约交互、账户余额变化以及 Gas 费用估算。
实时更新: 支持 Server-Sent Events (SSE) 技术，提供实时的分析结果推送。
MCP 协议集成: 完全兼容 Model Context Protocol 协议，可无缝接入 MCP 客户端。

安装步骤

克隆仓库

git clone https://github.com/SmartTokenLabs/TransactionSimulatorMCP
cd TransactionSimulatorMCP

安装依赖
```
npm install
```

配置环境变量 在项目根目录下创建 '.env' 文件，并根据需要配置以下环境变量：

TENDERLY_ACCOUNT=你的Tenderly账户名
TENDERLY_PROJECT=你的Tenderly项目名
TENDERLY_API_KEY=你的Tenderly API密钥
OPENAI_API_KEY=你的OpenAI API密钥
GEMINI_API_KEY=你的Gemini API密钥
CERT_PATH=/ssl/证书路径  # 生产环境HTTPS需要配置SSL证书路径

注意:

'TENDERLY_ACCOUNT', 'TENDERLY_PROJECT', 'TENDERLY_API_KEY' 用于 Tenderly 交易模拟服务。
'OPENAI_API_KEY' 和 'GEMINI_API_KEY' 用于 AI 分析服务，至少需要配置一个。
'CERT_PATH' 为可选配置，仅在生产环境启用 HTTPS 时需要，指向 SSL 证书的目录。

服务器配置 (MCP 客户端)

要将此 MCP 服务器添加到 MCP 客户端（例如 Cursor 或 Claude Desktop），您需要配置服务器的启动命令和参数。以下是针对 Cursor 和 Claude Desktop 的配置示例：

Cursor 配置 (JSON)

"mcpServers": {
    "transaction-sim-server": {
      "url": "<部署后的服务器URL>"
    }
}

Claude Desktop 配置 (JSON)

"mcpServers": {
  "transaction-simulator": {
    "command": "npx", // 启动命令，使用 npx 执行
    "args": [
      "mcp-remote", // mcp-remote 命令
      "<部署后的服务器URL>" // 服务器 URL，需要替换为实际部署地址
    ]
  }
}

配置说明:

'"server name"': 自定义服务器名称，例如 'transaction-sim-server' 或 'transaction-simulator'。
'"url"': 服务器部署后的 URL 地址，例如 'https://your-server-domain.com:8084/sse' (生产环境HTTPS) 或 'http://localhost:8084/sse' (开发环境HTTP)。
'"command"' (仅 Claude Desktop): 指定启动服务器的命令，这里使用 'npx' 运行 'mcp-remote'。
'"args"' (仅 Claude Desktop): 命令参数，'mcp-remote' 接收服务器 URL 作为参数。

重要提示:

'<部署后的服务器URL>' 需要替换为您实际部署服务器的地址。
如果您在本地开发环境运行服务器，可以使用 'http://localhost:8084/sse' 作为 URL。
生产环境建议使用 HTTPS 协议，并配置 SSL 证书。

基本使用方法

启动服务器
- 开发模式: 运行 'npm run dev' 命令启动开发服务器。
- 生产模式: 运行 'npm run prod' 命令启动生产服务器 (确保已配置 SSL 证书和 HTTPS)。

在 MCP 客户端中使用

在 Cursor 或 Claude Desktop 等 MCP 客户端中配置并添加上述服务器配置。
在聊天窗口中，按照以下格式输入交易参数，即可触发交易模拟和分析：

Computer, please determine if this transaction is safe:

networkId: 8453
from: 0x331F914d9447F0E4BEcAB98d62BEA00dADb8B591
to: 0x24fcFC492C1393274B6bcd568ac9e225BEc93584
data: 0x095ea7b3000000000000000000000000cf77a3ba9a5ca399b7c97c74d54e5b1beb874e43000000000000000000000000000000000000000000002e961634f872dfc30000

参数说明: - 'networkId': 交易所属网络 ID (例如 8453 代表 Base 网络)。 - 'from': 发送方地址。 - 'to': 接收方地址。 - 'data': 交易数据 (可选)。 - 'value': ETH 数值 (可选)。

查看分析结果
- 服务器将模拟交易并在 MCP 客户端中返回 AI 生成的交易分析报告，帮助您理解交易的潜在影响和安全性。

关键词

以太坊交易分析, 交易模拟, AI解读, 智能合约安全, DeFi风险评估

关键词