| name | tdxquant-mcp-sse |
| description | 当用户需要 A 股行情、K 线/Tick、财务、板块、通达信公式、可转债/新股、交易日历或交易查询， 且通过本仓库的 MCP **HTTP/SSE** 服务（FastMCP，`/sse`）接入时使用。要求本机已配置 TQ_PATH、 通达信/TdxQuant 可用，并已启动 `tdx_mcp.main_http`。先 tools_catalog，再按需调用具体工具； 平台背景可 docs_get_tdxquant_intro。交易类工具默认 dry-run，勿替用户关闭。
|
TdxQuant MCP（SSE）技能
何时使用
- 用户要查 K 线、Tick、快照、板块成分、财务、公式、交易日历、可转债/新股 等，并声明或隐含使用 本项目的 MCP 服务。
- 宿主已通过 SSE 连接到运行中的
tdx_mcp.main_http（不是 stdio 子进程场景时，仍适用同一套工具名与工作流）。
硬前提（调用任何业务工具前）
- 通达信 / TdxQuant 终端已按官方要求可用（登录、数据下载等由用户侧保证）。
- 环境变量
TQ_PATH 已设置，否则服务进程无法启动。
- HTTP/SSE 服务已启动（示例）：
uv sync --extra httpuv run python -m tdx_mcp.main_http
- 客户端配置的 SSE URL 须指向 FastMCP 默认路径：
http://<MCP_HOST>:<MCP_PORT>/sse（默认常为 http://127.0.0.1:8765/sse，以 .env 为准）。
若连接失败，核对：进程是否存活、防火墙、URL 是否包含 /sse 后缀。
推荐调用顺序
tools_catalog（无参数）— 获取当前服务注册的分类与工具精确名称（下划线风格，如 market_get_kline，禁止写成 market.get_kline）。- 需要向用户说明 TdxQuant 是什么、运行环境、tqcenter 能力 时：
docs_get_tdxquant_intro（无参数），以返回的 content 为准。
- 按任务调用具体工具；参数细节以工具 schema 与仓库内
docs/agent-usage.md 为准。
更细的「意图 → 工具」表见同目录 references/workflow.md。
证券代码
- 沪深示例：
600519.SH、000001.SZ（市场后缀大写）。
安全与合规
trade_order_stock / trade_cancel_order_stock 等：默认 dry_run=true，仅预览；仅在用户明确授权且理解风险时才可使用 dry_run=false，不得默认替用户关闭。- Hermes 等宿主：建议对 MCP 工具做
include 白名单，缩小暴露面；见 Hermes：Use MCP with Hermes。
- 禁止在缺少工具返回时编造行情或财务数字；空结果应提示检查终端、数据下载与代码格式。
各宿主 MCP 配置片段
可复制示例见 references/host-config-snippets.md（Claude Code、OpenClaw、Hermes）。
仓库文档（人类与 Agent 共读）
| 文档 | 内容 |
|---|
docs/mcp-configuration.md | stdio / HTTP、环境变量、排错 |
docs/agent-usage.md | 完整工作流、意图表、交易说明 |
docs/tdxquant-intro.md | 平台简介索引与 docs_get_tdxquant_intro |
协议说明
当前 main_http 使用 SSE（非 streamable-http）。若未来服务端改为 Streamable HTTP，需同步更新客户端 transport / URL（以 OpenClaw / Claude Code 文档为准）。
