MCP 服务器

TronSave MCP 服务器 —— 通过 Streamable HTTP 让 AI 智能体驱动 TronSave 的身份验证、订单、定价和代理(委托)工作流。

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

核心能力:

  • 位于 /mcp 的 Streamable MCP 端点(POSTGETDELETE

  • 双重身份验证模型(ApiKeySignature

  • 借助 Redis TTL 实现的会话与 nonce 安全机制

  • 类型化的 GraphQL 与 REST 集成

  • 所有工具均采用严格的输入/输出 schema

使命

TronSave 统一资源操作

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

身份验证模型

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

  • ApiKey —— 使用你的 TronSave API 密钥进行身份验证。所有内部操作工具均需此凭据。

  • Signature —— 使用钱包签名的消息进行身份验证。部分平台工具需此凭据。

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

内部工具始终需要 API 密钥会话。部分平台工具需要 Signature 会话。在 Requires Login 列中标记为 No 的工具可在 MCP 初始化后立即调用,无需任何登录步骤。

参阅 Authentication 了解如何获取 API 密钥,以及如何在 API 密钥方式和签名交易方式之间进行选择。

工具分类

平台身份验证与身份

工具
需要登录
描述

tronsave_get_sign_message

返回供钱包签名以进行 Signature 登录的一次性消息/nonce。

tronsave_login

使用 ApiKey 或 Signature 凭据创建服务器会话。

tronsave_user_info_get

获取已验证平台用户的个人资料级信息。

tronsave_user_permissions_get

返回当前平台会话已授予的权限/范围。

tronsave_user_auto_setting_get

获取与平台用户行为相关的当前自动设置。

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

工具
需要登录
描述

tronsave_order_book

返回公开的买/卖市场深度和当前订单簿数据。

tronsave_orders_list

列出当前用户/会话上下文的平台订单。

tronsave_order_detail

获取某个特定平台订单的详细信息。

tronsave_order_create

使用旧版嵌套载荷格式创建订单。

tronsave_order_create_onchain

使用 ONCHAIN 支付模式和扁平输入创建新订单。

tronsave_order_create_internal

使用 INTERNAL 余额和扁平输入创建新订单。

tronsave_order_create_pending

创建一个等待充值/结算流程的待处理订单。

tronsave_order_update

更新现有订单的可编辑字段。

tronsave_order_cancel

在取消规则允许时取消一个开放订单。

tronsave_order_sell_manual

为符合条件的资源持仓/订单触发手动卖出流程。

tronsave_estimate_buy_resource

在创建买入订单之前预估预期数量/成本。

tronsave_energy_price_table_get

返回能量/资源市场的定价表快照。

tronsave_user_seller_energy_stats_get

返回卖家侧的业绩和能量统计数据。

tronsave_extendable_delegates_get

列出可被扩展的代理(委托)条目。

内部操作

工具
需要登录
描述

tronsave_internal_account_get

获取 API 密钥会话的内部账户/余额详情。

tronsave_get_deposit_address

返回内部充值工作流的充值地址。

tronsave_internal_order_history

列出内部订单历史记录,支持筛选。

tronsave_internal_order_details

返回某条内部订单记录的完整详情。

tronsave_internal_order_estimate

在提交前为内部订单计算预估。

tronsave_internal_order_create

使用内部工作流参数创建新的内部订单。

tronsave_internal_extend_delegates

在内部工作流中扩展代理(委托)的时长/条款。

tronsave_internal_extend_request

为内部代理(委托)/订单流程提交扩展请求。

连接

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

该端点使用 Streamable HTTP 传输,接受 POSTGETDELETE 请求。将任意兼容 MCP 的客户端(例如 AI 智能体运行时)指向该主机端点:

后续步骤

Last updated