TradeStaq — AI Trading Intelligence

TradeStaq MCP 服务

网站 · 文档 · MCP / AI 工具 · 定价

为 Claude、Cursor 和任何 MCP 客户端提供 46 种 AI 驱动的交易工具。

通过对话即可创建策略、回测策略、部署交易机器人、跟随顶级交易员、监控仓位并管理加密货币投资组合。支持 Binance、Bybit、OKX、Bitget、Hyperliquid、dYdX 等平台。

"Show me my portfolio" → get_portfolio
"Backtest GhostRider on BTC/USDT for 3 months" → what_if_backtest
"Deploy it on my Binance account" → deploy_bot
"Who are the top traders this month?" → list_top_traders
"Generate a momentum strategy for ETH" → generate_strategy

快速开始

选项 A：远程服务（无需安装）

适用于支持 HTTP 传输的 MCP 客户端：

{
  "mcpServers": {
    "tradestaq": {
      "url": "https://mcp.tradestaq.com/mcp"
    }
  }
}

选项 B：npx（本地使用推荐）

无需克隆，无需构建。只需添加到 MCP 配置中：

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "tradestaq": {
      "command": "npx",
      "args": ["-y", "@the-staq/tradestaq-mcp"]
    }
  }
}

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "tradestaq": {
      "command": "npx",
      "args": ["-y", "@the-staq/tradestaq-mcp"]
    }
  }
}

Claude Code：

claude mcp add tradestaq -- npx -y @the-staq/tradestaq-mcp

选项 C：克隆并构建

git clone https://github.com/the-staq/tradestaq-mcp.git
cd tradestaq-mcp
npm install
npm run build

然后将 MCP 客户端指向 dist/index.js。

身份验证

添加服务后，请 AI 助手为你登录：

• “让我登录 TradeStaq” — 直接使用电子邮件和密码
• “使用 TradeStaq 进行身份验证” — 打开浏览器窗口，通过安全的 OAuth 登录

使用浏览器流程时，聊天中不会出现凭据。令牌会以受限权限（0600）存储在本地 ~/.tradestaq/mcp-config.json 中。

工具

身份验证

工具	说明
login	使用电子邮件和密码登录
authenticate	通过浏览器登录（OAuth + PKCE）
check_auth	检查身份验证状态
set_token	手动设置 JWT 令牌
connect_exchange	通过浏览器连接交易所账户
logout	删除已存储的凭据

市场数据

工具	说明
get_price	当前价格、24 小时涨跌幅、成交量
get_candles	OHLCV 蜡烛图数据（1m 至 1d）
list_exchanges	列出已连接的交易所账户
search_markets	在指定交易所查找交易对

投资组合

工具	说明
get_portfolio	总余额、交易所、活跃机器人
get_positions	未平仓位及实时盈亏

策略

工具	说明
list_strategies	浏览市场或你自己的策略
get_strategy	策略详细信息和表现
explain_strategy	使用通俗易懂的语言说明策略及其风险概况
compare_strategies	并排比较各项指标
create_strategy	根据 TradeDroid 代码创建策略
generate_strategy	使用 AI 根据自然语言生成策略

回测

工具	说明
what_if_backtest	运行历史回测（异步，30-120 秒）
get_backtest_results	查看正在运行的回测状态

机器人管理

工具	描述
list_bots	列出所有机器人及其状态和表现
get_bot_status	查看机器人的详细指标和配置
get_bot_logs	按次查看历史记录：机器人为何进行或未进行交易、信号丢弃情况及错误
deploy_bot	将策略部署为交易机器人
update_bot	编辑机器人：重命名、切换策略或应用预设、设置时间周期、执行模式、策略参数、版本渠道、风险设置、通知以及 stopAfterClose
start_bot	启动已暂停或已停止的机器人
stop_bot	立即停止正在运行的机器人（未平仓头寸将不再受管理）
delete_bot	删除机器人（有未平仓交易时无法删除）
close_position	平仓（全部或部分）

deploy_bot 默认使用模拟交易。传入 live: true 可进行真实资金交易。机器人使用策略自身的时间周期进行交易；仅在需要覆盖时传入 timeframe（例如 4h）。省略 name 时，服务会为机器人命名。

update_bot 会将传入的所有内容合并到机器人的当前设置中后一次性更新（部分更改不会清除仓位大小、旋转设置和参数覆盖）。只有传入大小和杠杆时才会更改它们。strategyId 和 presetId 可以使用 ID 或 slug（trade-wind、trade-wind-long-short）。更改策略或时间周期时，机器人必须处于空仓状态：先通过 stopAfterClose: true 暂停机器人，等待 get_bot_status 显示没有未平仓头寸，然后切换设置，最后调用 start_bot。更改实盘机器人时需要 mcp:live 范围；更改模拟交易机器人时需要 mcp:paper 范围。响应会返回最终配置（策略、版本、时间周期、模式、覆盖项、大小、杠杆、状态）以及服务端警告。

例如，将一个已暂停的 15m GhostRider 机器人切换到 4h 的 Trade Wind，应用 Long & Short 预设并重命名：

{ "id": "6ab7c2d60014ba19b0c54258", "presetId": "trade-wind-long-short", "timeframe": "4h", "name": "Trade Wind · SUI · 4h" }

交易历史

工具	描述
get_trade_history	查看已平仓交易及其 PnL、入场价和出场价
get_performance_metrics	查看 ROI、胜率、Sortino 比率和 PnL 明细

跟单交易

工具	描述
list_top_traders	浏览顶级交易员排行榜
follow_trader	订阅并跟随交易员的交易

顾问

工具	描述
suggest_strategies	根据你的风险状况匹配策略
get_market_context	查看某个交易品种的趋势、波动性、支撑位和阻力位

提示词模板

交易助手 — 开始讨论你的投资组合和头寸。AI 会调用 get_portfolio 和 get_positions，根据你的实际数据生成回复。

策略构建器 — 引导你创建、回测和部署策略。可选传入 goal，例如 "momentum strategy for ETH"，以获取更有针对性的建议。

投资组合审查员 — 深入分析你的投资组合、头寸、交易历史和表现，识别哪些方面有效、哪些无效，并提出改进建议。

资源

MCP 资源提供可浏览的数据，AI 客户端可直接读取：

资源	URI	描述
投资组合	tradestaq://portfolio	余额、头寸和活跃机器人
机器人	tradestaq://bots	所有机器人及其状态和 PnL
策略	tradestaq://strategies	含评级的策略目录

架构

                    stdio                                    HTTPS
┌──────────────┐◄──────────►┐                  ┌────────────────►┌──────────────┐
│Claude Desktop│             │                  │                 │              │
│Cursor / CLI  │             │  tradestaq-mcp   │   Bearer JWT    │  TradeStaq   │
└──────────────┘             │  46 tools        │◄────────────────│  API         │
                             │  3 prompts       │                 │              │
┌──────────────┐  HTTP+SSE  │  3 resources      │                 └──────────────┘
│ Any MCP      │◄──────────►│                  │
│ client (web) │             └──────────────────┘
└──────────────┘

• 两种传输方式： stdio（本地，默认）和 HTTP+SSE（远程，使用 --http 标志）
• 托管于 https://mcp.tradestaq.com/mcp，供远程客户端使用
• 通过 OAuth PKCE 或电子邮件/密码登录进行 JWT 身份验证
• 所有工具均返回结构化 JSON，并遵循错误约定
• 令牌将在 1 小时内过期时自动刷新

开发

npm run dev        # watch mode with tsx
npm run build      # compile TypeScript
npm run lint       # type check without emitting
npm test           # run tests
npm start          # run server (stdio)
npm run start:http # run server (HTTP+SSE on port 3100)

发布

npm run release:patch   # or release:minor / release:major

此操作会递增版本号（以及 server.json 中的版本号），将 CHANGELOG 中 [Unreleased] 下的说明归档到该版本，创建提交、打上 vX.Y.Z 标签并推送。该标签会触发 .github/workflows/publish.yml：

1. 批准运行。 发布任务会在 npm 环境中等待维护者批准（依次点击 Actions、对应运行，然后点击 Review deployments）。
2. 它会进行类型检查、测试，并通过可信发布流程发布到 npm（无需使用任何 npm 令牌），同时提供来源证明。
3. 它会更新官方 MCP Registry 中的项目条目。

然后运行 Deploy MCP 工作流，更新托管在 mcp.tradestaq.com 上的服务。

错误处理

所有工具错误都会返回结构化响应：

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Human-readable description",
    "retryable": true,
    "retryAfterMs": 5000
  }
}

错误代码：AUTH_EXPIRED、TIMEOUT、RATE_LIMITED、NETWORK_ERROR、HTTP_4xx、HTTP_5xx。

安全

• 凭据不会进入 AI 对话历史记录
• 通过基于浏览器的身份验证使用 OAuth PKCE 流程
• 令牌以 0600 文件权限存储
• OAuth 回调仅限 localhost
• deploy_bot、stop_bot、close_position 和 follow_trader 是破坏性操作（AI 会向用户确认）

链接

• 网站： tradestaq.com
• 文档： tradestaq.com/docs
• MCP 和 AI 交易工具： tradestaq.com/mcp
• 定价： tradestaq.com/pricing
• npm 包： @the-staq/tradestaq-mcp

许可证

MIT