MCP

托管研究引擎 MCP

让 Cursor、VS Code 和其他 MCP 客户端调用与研究台相同的分析任务、自选、积分和模拟交易。配置里只加 URL,然后登录。不要把 token 写进配置文件。

传输
Streamable HTTP
登录
研究台 OAuth · PKCE
工具
27 个研究台工具

同一套研究台,从编辑器调用

MCP 端点挂在研究台 Node BFF 上。工具走同一套 /api、同一用户、同一积分门槛和模拟交易开关。分析是异步的:start_analysis 立刻返回 id,轮询 get_analysis,再取 get_analysis_report。不是实盘券商,也不是 TradingView 行情 MCP 的克隆。

一键或一条命令安装

Cursor 和 VS Code 不必手改 JSON。其他客户端粘贴托管 URL。首次连接会打开研究台登录,然后是授权页。

一键安装

Cursor

打开 Cursor 并加入托管服务。按提示用研究台同一账号登录。

添加到 Cursor

粘贴 URL

Claude Desktop / claude.ai

Customize → Connectors → Add custom connector。粘贴托管 URL,然后登录。

打开 Claude Connectors →
MCP URL
https://mcp.tradingagentsreport.com/mcp

命令行客户端

复制命令,再在客户端里完成研究台登录。

Claude Code
claude mcp add --transport http tradingagents-report https://mcp.tradingagentsreport.com/mcp

然后在会话里运行 /mcp,完成浏览器登录。

Codex
codex mcp add tradingagents-report --url https://mcp.tradingagentsreport.com/mcp
codex mcp login tradingagents-report

第二行会在浏览器打开研究台。

Gemini CLI
gemini mcp add --transport http tradingagents-report https://mcp.tradingagentsreport.com/mcp

若 Gemini 要求鉴权,运行 /mcp auth tradingagents-report。

其他客户端与 JSON 配置

没有安装链接或 CLI 时用这些。旧客户端可能写 streamable-http 而不是 http,URL 相同。不要加 Authorization 头,token 由 OAuth 下发。

mcpServers
{
  "mcpServers": {
    "tradingagents-report": {
      "type": "http",
      "url": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Cursor:~/.cursor/mcp.json。Claude Desktop:~/Library/Application Support/Claude/claude_desktop_config.json。

VS Code · servers
{
  "servers": {
    "tradingagents-report": {
      "type": "http",
      "url": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

工作区:.vscode/mcp.json。VS Code 用 servers,不是 mcpServers。

VS Code CLI
code --add-mcp '{"name":"tradingagents-report","type":"http","url":"https://mcp.tradingagentsreport.com/mcp"}'
Windsurf
{
  "mcpServers": {
    "tradingagents-report": {
      "serverUrl": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Windsurf:~/.codeium/windsurf/mcp_config.json。远程字段是 serverUrl,不是 url。

工具覆盖什么

二十七个工具转发研究台接口。分析任务保持异步。报价和新闻是研究台快照,不是完整指标包。模拟下单扣产品积分作手续费,不会到达券商。

分析任务

提交标的、轮询进度、读取决策卡和报告、查看历史或取消。提交前校验积分。

行情快照

解析上市地后取报价、K 线、时段快照、新闻和公司身份。完整报表在已完成的研究报告里。

自选股

列出、加入或移除当前用户的自选。加入时可以只传 ticker,由工具解析上市地。

积分与套餐

查看套餐/普通账户余额、发票,以及能否开跑新分析。结账仍在浏览器里完成。

模拟交易

开通模拟账户、查看权益与成交、领取签到、下单或撤单。受功能开关控制;不是实盘成交。

研究

resolve_listing

把代码规范成交易所、symbol 和 provider_symbol。

研究

start_analysis

提交异步研究任务,立刻返回 id。

研究

get_analysis

任务状态与进度。成功后用 get_analysis_report。

研究

get_analysis_events

运行中或已完成任务的阶段时间线。

研究

get_analysis_report

成功后的决策卡与报告章节。

研究

list_analyses

列出当前用户最近的分析任务。

研究

cancel_analysis

请求取消排队或运行中的任务。

积分

estimate_analysis

检查积分是否达到开跑门槛。

行情

get_quote

EXCHANGE:SYMBOL 的最新报价。

行情

get_ohlcv

K 线。周期默认 D。

行情

get_ta_summary

最新价、时段与身份快照。不是完整指标包。

行情

get_news

标的近期新闻标题。

行情

get_fundamentals

公司名称、交易所与 logo。报表在研究报告里。

自选

list_watchlist

列出当前用户的自选。

自选

add_watchlist_item

加入自选。只传 ticker 即可,工具会解析其余字段。

自选

remove_watchlist_item

按 id 删除自选。

积分

get_usage

套餐积分、普通账户与本周期账本。

积分

get_subscription

当前套餐、待切换与发票。只读。

模拟

open_paper_account

开通默认 10,000 美元模拟账户,或返回已有账户。

模拟

get_paper_account

现金、权益、盈亏与持仓。

模拟

list_paper_orders

默认或指定账户的模拟订单。

模拟

list_paper_fills

模拟成交。

模拟

list_paper_cash_ledger

开户赠金、签到与资金调整。

模拟

get_paper_checkin

每日模拟美元签到状态。

模拟

claim_paper_checkin

领取今日模拟美元签到。

模拟

place_paper_order

下限价或市价模拟单。不是实盘券商。

模拟

cancel_paper_order

撤销挂起或已触发的模拟订单。

可以这样问助手

登录后通常不必重启。用能对应到工具的提示词。

  • 用市场、新闻和基本面分析今天的 NASDAQ:AAPL。
  • 我的自选有哪些,哪些有未平仓模拟持仓?
  • 我还有多少积分,能不能一次开两个分析?
  • 给我 HKEX:700 的最新报价和近期新闻。
  • 如有需要就开通模拟账户,并显示现金和权益。
  • 用市价模拟买入 10 股 NASDAQ:AAPL。

在研究台登录

首次连接会打开研究台登录,然后是授权页。与网页研究台使用同一账号。运营无需在 Clerk Dashboard 打开 OAuth applications 或 Dynamic Client Registration。嵌入式浏览器登不上时,把链接复制到系统浏览器。

MCP 不会做什么

托管 MCP 是研究台适配层,沿用产品边界。

  • 不下真实券商订单,也不持有真实资金。
  • 不发起 Stripe Checkout 或客户门户。
  • 不暴露管理端、队列或 API Key 工具。
  • 模拟交易关闭时,相关工具返回 PAPER_FEATURE_DISABLED。
  • 分析仍从与网页研究台相同的积分账本扣费。

若需要更深的行情、选股器和日历,可并用 TradingView MCP。本端点是研究引擎,不是第二套行情 MCP。 TradingView MCP

MCP 常见问题

关于托管 MCP 的常见问题

MCP 配置里要放 API key 吗?

不需要。Cursor、VS Code 和 CLI 只加 URL。研究台登录后会发短期 access token。不要粘贴 Clerk、Stripe 或 Core 密钥。

用的是哪个账号?

与浏览器研究台相同的账号。自选、任务、积分和模拟交易都是该用户的数据。

分析任务在 MCP 里怎么跑?

start_analysis 立刻返回 id。轮询 get_analysis 直到 succeeded,再调用 get_analysis_report。不要把提交当成已经出报告。

助手能替我交易吗?

只能下模拟单,且仅在模拟交易开启时。手续费扣产品积分。不会发到券商。