trade-router-mcp

@traderouter/trade-router-mcp

一个适用于 TradeRouter.ai 的 Model Context Protocol 服务——面向 AI Agent 的非托管 Solana 交换、限价、跟踪、DCA、TWAP 和组合订单引擎。

安全吗？

安全，原因如下。 私钥只会从 TRADEROUTER_PRIVATE_KEY 读取一次，用于通过 @solana/web3.js + tweetnacl 在本地签名，绝不会被传输、记录或持久化。只有已签名的交易会离开你的设备。服务消息会使用硬编码的信任锚进行 Ed25519 验证。完整的威胁模型、数据流图和权限清单，请参阅 SECURITY.md。

签名流程：

1. Agent 调用 build_swap → MCP 将钱包地址（公钥）发送至 api.traderouter.ai
2. API 返回一笔未签名的交易
3. MCP 使用 TRADEROUTER_PRIVATE_KEY 在本地对交易签名
4. 将已签名的交易提交至 /protect（受 Jito MEV 保护的捆绑交易）
5. 服务确认交易并返回余额变化。私钥绝不会经过网络。

要求

• Node.js ≥ 18
• Base58 格式的 Solana 钱包私钥（请使用专用交易钱包，而非存放主要资产的钱包）

安装

npx -y @traderouter/trade-router-mcp

也可以将其接入 MCP 客户端（Claude Desktop、Cursor、Cline 等）：

{
  "mcpServers": {
    "traderouter": {
      "command": "npx",
      "args": ["-y", "@traderouter/trade-router-mcp"],
      "env": {
        "TRADEROUTER_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

操作系统	Claude Desktop 配置文件路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

环境变量

变量	必需	默认值	用途
TRADEROUTER_PRIVATE_KEY	✅	—	Solana 钱包私钥（Base58）。仅在本地使用。
SOLANA_RPC_URL	❌	https://api.mainnet-beta.solana.com	用于读取的自定义 RPC
TRADEROUTER_SERVER_PUBKEY	❌	内置信任锚	覆盖服务的 Ed25519 信任锚
TRADEROUTER_SERVER_PUBKEY_NEXT	❌	（未设置）	除主密钥外，还接受由此密钥签名的消息（密钥轮换）
TRADEROUTER_REQUIRE_SERVER_SIGNATURE	❌	true	验证服务对 order_filled / twap_execution 的签名
TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE	❌	true	验证服务对 order_created 的签名
TRADEROUTER_DRY_RUN	❌	false	为 true 时，所有写入操作工具（submit_signed_swap、auto_swap、place_*_order、cancel_order、extend_order）都会返回 { dry_run: true, tool, args }，而不会调用 API。只读工具照常执行。于 1.0.9 版本加入。

工具

工具	用途
get_wallet_address	获取已配置钱包的公开地址
build_swap	构建未签名的兑换交易
submit_signed_swap	提交手动签名的交易
auto_swap	一次调用即可构建、签名并提交
get_holdings	获取钱包的代币持仓
get_mcap	获取代币的市值和价格
get_flex_card	获取钱包和代币的交易卡片 PNG URL
place_limit_order	按价格或市值进行限价买入／卖出
place_trailing_order	跟踪止损买入／卖出
place_twap_order	TWAP（时间加权）买入／卖出
place_limit_twap_order	限价触发 → TWAP 执行
place_trailing_twap_order	跟踪触发 → TWAP 执行
place_limit_trailing_order	限价触发 → 跟踪执行（触发时进行单次兑换）
place_limit_trailing_twap_order	限价触发 → 跟踪触发 → TWAP 执行
list_orders	列出钱包的活动订单
check_order	获取特定订单的状态
cancel_order	取消活动订单
extend_order	延长订单的到期时间
connect_websocket	通过持久 WebSocket 注册钱包
connection_status	当前 WebSocket 连接状态
get_fill_log	已成交订单的日志

REST 端点（底层实现）

端点	用途
POST /swap	构建未签名的兑换交易（多 DEX：Raydium、PumpSwap、Orca、Meteora）
POST /protect	通过 Jito bundle 提交已签名的交易 — 受到 MEV 保护
POST /holdings	钱包扫描 — 可捕获标准 RPC 会遗漏的代币
GET /mcap	获取市值和价格
GET /flex	生成交易卡片 PNG
wss://api.traderouter.ai/ws	用于限价、跟踪、DCA、TWAP 和组合订单的持久 WebSocket

信任锚

内置的服务公钥为 EXX3nRzfDUvbjZSmxFzHDdiSYeGVP1EGr77iziFZ4Jd4。来自服务端的每条 order_filled、order_created 和 twap_execution 消息都会先通过 Ed25519 验证，再视为权威信息。详情及密钥轮换机制（TRADEROUTER_SERVER_PUBKEY_NEXT）请参阅 SECURITY.md。

与 LangChain 搭配使用

任何 MCP 服务都可以通过官方适配器在 LangChain 中使用：

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "traderouter": {
        "command": "npx",
        "args": ["-y", "@traderouter/trade-router-mcp"],
        "transport": "stdio",
        "env": {"TRADEROUTER_PRIVATE_KEY": "<base58>"},
    },
})
tools = await client.get_tools()

费用

兑换交易量按 1% 收取固定费用，并计入 /protect 的路由中。无订阅、无 API 密钥、无月度最低消费。只读端点（/holdings、/mcap）免费。

机器可读规范（可在 traderouter.ai 上获取）

URL	格式	用途
https://traderouter.ai/openapi.json	OpenAPI 3.1 (JSON)	规范的 API 契约 — 可用于生成任意语言的 SDK
https://traderouter.ai/openapi.yaml	OpenAPI 3.1 (YAML)	相同规范的 YAML 格式（由 JSON 重新生成）
https://traderouter.ai/llms.txt	text	适用于大模型阅读的 API 指南（遵循 llmstxt.org）
https://traderouter.ai/SKILL.md	markdown	Anthropic Agent Skills 格式 — 完整实现指南
https://traderouter.ai/SECURITY.md	markdown	威胁模型 + 数据流图 + 权限清单（此处 ./SECURITY.md 的镜像）
https://traderouter.ai/CHANGELOG.md	markdown	涵盖 API、MCP 服务和 Site 版本轨道的统一变更日志

快速生成 SDK：

# TypeScript
openapi-generator-cli generate -i https://traderouter.ai/openapi.yaml -g typescript-axios -o ./sdk-ts

# Python
openapi-generator-cli generate -i https://traderouter.ai/openapi.yaml -g python -o ./sdk-py

安全问题披露

请发送邮件至 [email protected]，或通过此仓库的 GitHub Security Advisories 提交。我们将在 48 小时内确认收到。请参阅 SECURITY.md（如果您更想链接到稳定 URL，也可参阅托管版本）。

许可证

MIT。请参阅 LICENSE。

变更日志

请参阅 CHANGELOG.md。