TronGrid MCP 服务器。把 TRON 链上能力封装为 MCP 标准工具，供 AI 客户端（Claude、Cursor、自定义 Agent 等）调用。

TronGrid MCP 服务器指南

1. 简介

TronGrid MCP 服务器是一项基于 Model Context Protocol（MCP） 的服务，它将 TRON 区块链上的查询与操作能力封装为标准化的 MCP 工具。这使 AI 客户端（如 Claude、Cursor、自定义 Agent 等）能够直接与 TRON 网络进行交互。

2. 快速入门

MCP 服务 URL

协议

• MCP 协议版本：2025-11-25
• 传输协议：Streamable HTTP

3. 客户端配置

3.1 Claude Desktop

编辑配置文件：

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

{
  "mcpServers": {
    "trongrid": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.trongrid.io/mcp"
      ]
    }
  }
}

传入 API key：

{
  "mcpServers": {
    "trongrid": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.trongrid.io/mcp",
        "--header",
        "TRON-PRO-API-KEY:<your-api-key>"
      ]
    }
  }
}

3.2 Claude Code

方式一：CLI 命令

claude mcp add --transport http trongrid https://mcp.trongrid.io/mcp

方式二：项目配置文件

在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "trongrid": {
      "type": "http",
      "url": "https://mcp.trongrid.io/mcp"
    }
  }
}

4. MCP 协议基础

MCP 使用 Streamable HTTP 进行传输，所有通信均通过 POST /mcp endpoint 完成。协议是有状态的，需要按顺序完成握手：

┌──────────┐                      ┌──────────┐
│  Client  │                      │  Server  │
└────┬─────┘                      └────┬─────┘
     │  1. initialize                  │
     │ ──────────────────────────────► │
     │ ◄── mcp-session-id ──────────── │
     │                                 │
     │  2. notifications/initialized   │
     │ ──────────────────────────────► │
     │ ◄── 202 Accepted ────────────── │
     │                                 │
     │  3. tools/list                  │
     │ ──────────────────────────────► │
     │ ◄── tool list ───────────────── │
     │                                 │
     │  4. tools/call                  │
     │ ──────────────────────────────► │
     │ ◄── tool execution result ───── │
     └                                 ┘

请求头要求如下；握手后的请求还必须携带会话 ID 和协商出的协议版本：

5. 使用 curl 手动测试

步骤一 — 初始化（获取 Session ID）

curl -v -X POST https://mcp.trongrid.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": { "name": "curl-test", "version": "1.0" }
    }
  }'

在响应中找到 mcp-session-id，并从响应 JSON 的 result.protocolVersion 读取协商版本。将两者分别保存为 <your-session-id> 和 <protocol-version>，供后续请求使用。

步骤二 — 发送 initialized 通知

curl -X POST https://mcp.trongrid.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <your-session-id>" \
  -H "MCP-Protocol-Version: <protocol-version>" \
  -d '{
    "jsonrpc": "2.0",
    "method": "notifications/initialized",
    "params": {}
  }'

返回 202 Accepted 表示成功。

步骤三 — 查看可用工具

curl -X POST https://mcp.trongrid.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <your-session-id>" \
  -H "MCP-Protocol-Version: <protocol-version>" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

步骤四 — 调用工具

以查询区块统计信息为例：

curl -X POST https://mcp.trongrid.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <your-session-id>" \
  -H "MCP-Protocol-Version: <protocol-version>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "getBlockStatistics",
      "arguments": { "blockNum": 68000000 }
    }
  }'

6. 可用工具分类

服务器共暴露 149 个 MCP 工具，覆盖 TRON 网络的主要查询与操作：

6.1 HTTP REST API 查询工具（18 个）

通过 TronGrid REST API 查询链上数据。

区块（1 个）

账户（6 个）

资产（3 个）

合约（3 个）

事件（4 个）

TRC-20 通证（1 个）

6.2 钱包操作工具（73 个）

全节点 /wallet/* API endpoint，用于交易创建与广播、账户管理、资源质押与代理、智能合约、超级代表（SR）以及治理提案。

地址校验与交易广播（3 个）

账户管理（5 个）

TRX 转账（1 个）

账户资源查询（2 个）

资源质押与代理 — Stake 1.0（4 个）

资源质押与代理 — Stake 2.0（11 个）

区块查询（2 个）

交易查询（5 个）

网络与链参数（5 个）

其他链上查询（1 个）

TRC-10 资产管理（11 个）

智能合约（9 个）

超级代表（SR）管理（8 个）

SR 列表（1 个）

治理提案（5 个）

6.3 WalletSolidity 只读工具（25 个）

从已固化的 Solidity 节点读取数据，确保数据的最终性。所有工具名均以 solidity 为前缀。

账户（1 个）

交易查询（4 个）

区块查询（1 个）

资源代理查询（7 个）

节点与链信息（2 个）

智能合约（2 个）

TRC-10 资产查询（5 个）

超级代表查询（3 个）

6.4 JSON-RPC 工具（33 个）

兼容以太坊的 JSON-RPC API 方法，适用于从以太坊生态迁移的开发者。

账户与余额（1 个）

区块操作（7 个）

交易操作（6 个）

合约与存储（4 个）

过滤器与日志（6 个）

链与网络信息（9 个）

7. 与 AI 客户端集成

直连模式（支持 Streamable HTTP 的客户端）

在 MCP 客户端配置文件中添加以下配置：

{
  "mcpServers": {
    "trongrid-mcp": {
      "url": "https://mcp.trongrid.io/mcp"
    }
  }
}

通过 mcp-remote 桥接（Claude Code 等）

对于不直接支持 Streamable HTTP 的客户端（如 Claude Code），可使用 mcp-remote 作为桥接：

{
  "mcpServers": {
    "mcp-server-trongrid": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.trongrid.io/mcp"]
    }
  }
}

8. 常见问题

Q：工具调用返回 405 Method Not Allowed？

A：会话可能已过期或失效。请重新执行 initialize 握手流程。

Q：收到 TronGrid API 速率限制错误？

A：通过 TRON-PRO-API-KEY 请求头传入您的 API key。

Q：curl 请求没有返回数据？

A：请确保请求头包含 Accept: application/json, text/event-stream，这是 Streamable HTTP 协议的必填项。

相关资源

• AI Agent 技能 —— 基于本 MCP 服务器的预置自然语言工作流
• CLI —— 用于 TRON 读取类查询的命令行工具 trongrid-cli
• TronGrid V1 API 概览 —— 底层 API 参考