MCP 服务器
@tenergy/mcp 是针对 TEnergy 公开 API 的 Model Context Protocol (MCP) 服务器实现。您的 AI 编程代理可以通过它查询价格、获取报价并直接下单购买能量；服务端使用您的 API 密钥完成签名，密钥本身绝不会暴露给大语言模型。
工具列表 (Tools)
| 工具名称 | 是否需要密钥 | 功能说明 |
|---|---|---|
get_prices, get_address_resources | 否 | 查询实时价格表；查询目标接收地址当前的能量与带宽余额 |
estimate_transfer | 是 | 估算一次 USDT 转账所需的能量及总费用 |
get_balance, get_deposit_addresses | 是 | 查询预付余额；获取充值存款地址 |
create_quote, create_order | 是 (需扣款权限) | 锁定价格 120 秒；下单购买能量 |
get_order, list_orders | 是 | 查询订单状态与历史订单列表 |
内置资源 URI：tenergy://docs/quickstart, tenergy://llms.txt。
安装与配置
启动命令：npx -y @tenergy/mcp（stdio 模式）或 npx -y @tenergy/mcp --http 3333（HTTP 模式，访问 http://localhost:3333/mcp）。
Claude Desktop — claude_desktop_config.json:
{"mcpServers":{"tenergy":{"command":"npx","args":["-y","@tenergy/mcp"],"env":{"TENERGY_API_KEY":"...","TENERGY_API_SECRET":"..."}}}}
Claude Code:
claude mcp add tenergy -e TENERGY_API_KEY=... -e TENERGY_API_SECRET=... -- npx -y @tenergy/mcp
ChatGPT (设置 → Connectors → 开发者模式 → 添加 Connector)：运行 npx -y @tenergy/mcp --http 3333 并配置反向代理至公网 HTTPS，填入 https://<your-host>/mcp。
Cursor / Antigravity — mcp.json:
{"mcpServers":{"tenergy":{"command":"npx","args":["-y","@tenergy/mcp"],"env":{"TENERGY_API_KEY":"...","TENERGY_API_SECRET":"..."}}}}
环境变量配置
| 环境变量 | 默认值 | 作用说明 |
|---|---|---|
TENERGY_API_URL | https://api-nile.tenergy.me/v1 (Nile) | API 基准地址（包含 /v1）；连接生产环境请设置为 https://api.tenergy.me/v1 |
TENERGY_API_KEY, TENERGY_API_SECRET | 未设置 | 您的 API 密钥对，用于本地签名，绝不透传给模型。未设置时仅开放免密钥工具 |
TENERGY_SITE_URL | https://tenergy.me | 文档资源的主机地址 |
TENERGY_MCP_READ_ONLY | 未设置 | 设置为 1 时禁用 create_quote 和 create_order，即使提供了消费权限密钥也只读 |
TENERGY_MCP_MAX_ORDER_TRX | 50 | 单笔订单最高限额；超过此金额的订单将被直接拒绝，绝不扣款 |