> For the complete documentation index, see [llms.txt](https://docs.tronsave.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tronsave.io/chinese/developers/api-reference/mcp.md).

# MCP 服务器

`tron-save-mcp-server` 是面向生产环境的 TronSave 生态系统 [Model Context Protocol](https://modelcontextprotocol.io) 服务器。它通过 **Streamable HTTP** 传输将 TronSave 业务操作作为 MCP 工具暴露出来，并采用基于 Redis 的会话以及强类型的 TypeScript + Zod 契约。

**核心能力：**

* 位于 `/mcp` 的 Streamable MCP 端点（`POST`、`GET`、`DELETE`）
* 双重身份验证模型（`ApiKey` 和 `Signature`）
* 借助 Redis TTL 实现的会话与 nonce 安全机制
* 类型化的 GraphQL 与 REST 集成
* 所有工具均采用严格的输入/输出 schema

## 使命

**TronSave 统一资源操作**

该服务器为平台级和内部 TronSave 操作提供统一的 MCP 接口 —— 涵盖身份验证、账户数据、订单生命周期、定价/预估，以及代理(委托)扩展工作流。

## 身份验证模型

该服务器支持两种凭据类型：

* **`ApiKey`** —— 使用你的 TronSave API 密钥进行身份验证。所有**内部操作**工具均需此凭据。
* **`Signature`** —— 使用钱包签名的消息进行身份验证。部分平台工具需此凭据。

调用 `tronsave_get_sign_message` 获取一次性消息/nonce，用你的钱包对其签名，然后调用 `tronsave_login` 创建服务器会话。

{% hint style="info" %}
内部工具始终需要 **API 密钥会话**。部分平台工具需要 **Signature 会话**。在 **Requires Login** 列中标记为 `No` 的工具可在 MCP 初始化后立即调用，无需任何登录步骤。
{% endhint %}

参阅 [Authentication](/chinese/developers/authentication.md) 了解如何获取 API 密钥，以及如何在 API 密钥方式和签名交易方式之间进行选择。

## 工具分类

### 平台身份验证与身份

<table><thead><tr><th width="287">工具</th><th width="146">需要登录</th><th>描述</th></tr></thead><tbody><tr><td><code>tronsave_get_sign_message</code></td><td>否</td><td>返回供钱包签名以进行 Signature 登录的一次性消息/nonce。</td></tr><tr><td><code>tronsave_login</code></td><td>否</td><td>使用 ApiKey 或 Signature 凭据创建服务器会话。</td></tr><tr><td><code>tronsave_user_info_get</code></td><td>是</td><td>获取已验证平台用户的个人资料级信息。</td></tr><tr><td><code>tronsave_user_permissions_get</code></td><td>是</td><td>返回当前平台会话已授予的权限/范围。</td></tr><tr><td><code>tronsave_user_auto_setting_get</code></td><td>是</td><td>获取与平台用户行为相关的当前自动设置。</td></tr></tbody></table>

### 平台市场、订单与资源操作

<table><thead><tr><th width="218">工具</th><th width="151">需要登录</th><th>描述</th></tr></thead><tbody><tr><td><code>tronsave_order_book</code></td><td>否</td><td>返回公开的买/卖市场深度和当前订单簿数据。</td></tr><tr><td><code>tronsave_orders_list</code></td><td>否</td><td>列出当前用户/会话上下文的平台订单。</td></tr><tr><td><code>tronsave_order_detail</code></td><td>是</td><td>获取某个特定平台订单的详细信息。</td></tr><tr><td><code>tronsave_order_create</code></td><td>否</td><td>使用旧版嵌套载荷格式创建订单。</td></tr><tr><td><code>tronsave_order_create_onchain</code></td><td>否</td><td>使用 ONCHAIN 支付模式和扁平输入创建新订单。</td></tr><tr><td><code>tronsave_order_create_internal</code></td><td>否</td><td>使用 INTERNAL 余额和扁平输入创建新订单。</td></tr><tr><td><code>tronsave_order_create_pending</code></td><td>否</td><td>创建一个等待充值/结算流程的待处理订单。</td></tr><tr><td><code>tronsave_order_update</code></td><td>否</td><td>更新现有订单的可编辑字段。</td></tr><tr><td><code>tronsave_order_cancel</code></td><td>否</td><td>在取消规则允许时取消一个开放订单。</td></tr><tr><td><code>tronsave_order_sell_manual</code></td><td>否</td><td>为符合条件的资源持仓/订单触发手动卖出流程。</td></tr><tr><td><code>tronsave_estimate_buy_resource</code></td><td>否</td><td>在创建买入订单之前预估预期数量/成本。</td></tr><tr><td><code>tronsave_energy_price_table_get</code></td><td>是</td><td>返回能量/资源市场的定价表快照。</td></tr><tr><td><code>tronsave_user_seller_energy_stats_get</code></td><td>是</td><td>返回卖家侧的业绩和能量统计数据。</td></tr><tr><td><code>tronsave_extendable_delegates_get</code></td><td>否</td><td>列出可被扩展的代理(委托)条目。</td></tr></tbody></table>

### 内部操作

<table><thead><tr><th width="292">工具</th><th width="144">需要登录</th><th>描述</th></tr></thead><tbody><tr><td><code>tronsave_internal_account_get</code></td><td>是</td><td>获取 API 密钥会话的内部账户/余额详情。</td></tr><tr><td><code>tronsave_get_deposit_address</code></td><td>是</td><td>返回内部充值工作流的充值地址。</td></tr><tr><td><code>tronsave_internal_order_history</code></td><td>是</td><td>列出内部订单历史记录，支持筛选。</td></tr><tr><td><code>tronsave_internal_order_details</code></td><td>是</td><td>返回某条内部订单记录的完整详情。</td></tr><tr><td><code>tronsave_internal_order_estimate</code></td><td>是</td><td>在提交前为内部订单计算预估。</td></tr><tr><td><code>tronsave_internal_order_create</code></td><td>是</td><td>使用内部工作流参数创建新的内部订单。</td></tr><tr><td><code>tronsave_internal_extend_delegates</code></td><td>是</td><td>在内部工作流中扩展代理(委托)的时长/条款。</td></tr><tr><td><code>tronsave_internal_extend_request</code></td><td>是</td><td>为内部代理(委托)/订单流程提交扩展请求。</td></tr></tbody></table>

## 连接

MCP 服务器托管于 `https://mcp.tronsave.io/mcp`。该软件包以 `tron-save-mcp-server` 名称发布。

该端点使用 Streamable HTTP 传输，接受 `POST`、`GET` 和 `DELETE` 请求。将任意兼容 MCP 的客户端（例如 AI 智能体运行时）指向该主机端点：

```
https://mcp.tronsave.io/mcp
```

## 后续步骤

* [API 参考](/chinese/developers/api-reference.md) · [Authentication](/chinese/developers/authentication.md)
* [购买资源](/chinese/developers/api-reference/buy-resources.md) · [扩展订单](/chinese/developers/api-reference/extend-orders.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tronsave.io/chinese/developers/api-reference/mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.