MCP(AI 客户端) {#mcp}

MCP 用于在你自己使用的 AI 客户端里直接查行情(实时、K 线、涨停等)。配置写在客户端本地或设置页,不是写在我们服务器上;调用仍走同一套 API Key、scope、限流。

远程端点: http://data.klineshare.cn/mcp(Streamable HTTP)

配置步骤

  1. 在用户中心签发 API Key(tg_...
  2. 在 MCP 客户端中添加远程服务(见下方 JSON;各产品入口见门户 /docs/mcp 页的「兼容客户端」表)
  3. 保存并刷新 MCP 连接,在对话中提问,例如「查 600519.SS 最近 20 根日 K」

说明: 只有支持 MCP 的客户端才能接入。网页版 ChatGPT 等无法安装 MCP 时,请用 REST API,或将 llms-full.txt 作为上下文交给模型阅读。

鉴权

与 REST 相同,任选其一:

  • Header:X-API-Key: tg_xxx
  • Header:Authorization: Bearer tg_xxx
  • Query:?token=tg_xxx?api_key=tg_xxx

配置 JSON

Header 传 Key(推荐):

{
  "mcpServers": {
    "klineshare": {
      "url": "http://data.klineshare.cn/mcp",
      "headers": { "X-API-Key": "tg_你的密钥" }
    }
  }
}

Query 传 Key:

{
  "mcpServers": {
    "klineshare": {
      "url": "http://data.klineshare.cn/mcp?token=tg_你的密钥"
    }
  }
}

三种接入方式对比

方式作用
/v1/* REST程序、脚本、用户中心沙箱
llms-full.txt让模型读懂接口与参数(@Docs、粘贴上下文)
/mcp已配置 MCP 的客户端自动调工具查数据

可用工具

get_healthget_my_permissionsget_realtimeget_trendget_klineget_stocksearch_stockslist_stocksget_corpget_calendarget_limit_upget_limit_up_breakget_limit_down_poolget_yesterday_limit_upget_limit_up_ladderget_limit_up_plates_trendingget_limit_up_plates_industryget_limit_up_plates_conceptget_limit_up_plates_styleget_lhbget_lhb_dailyget_lhb_stockget_lhb_datesget_lhb_statsget_hot_moneyget_hot_money_by_seatget_moneyflow_daily_trendget_moneyflow_stageget_moneyflow_distributionget_market_indicesget_public_catalog,及 ETF 系列 get_etfsearch_etfsget_etf_realtimeget_etf_trendget_etf_kline(专业版、旗舰版)。

配置后在对话中直接提问即可触发工具;调用计入与普通 REST 相同的 scope 与限流。

兼容客户端

MCP 配在你的客户端上:Cursor 配在 Cursor,OpenClaw 配在 OpenClaw,互不通用。下表仅为常见产品;未列出者只要支持 MCP(stdio / SSE / Streamable HTTP),使用相同的远程 url 与鉴权即可。

类别工具配置入口
Claw / 龙虾 AgentOpenClaw~/.openclaw/openclaw.json5 → MCP 服务器
Claw / 龙虾 AgentClawHub MCP 技能clawhub install 后在 OpenClaw 启用
Vibe Coding · 国内CodeBuddy / WorkBuddy~/.codebuddy/.mcp.json 或 ~/.workbuddy/mcp.json
Vibe Coding · 国内TraeAI 面板 → 设置 → MCP
Vibe Coding · 国内通义灵码智能体 → MCP 工具;魔搭 MCP 广场或 JSON 配置
Vibe Coding · 国内文心快码 ComateMCP 市场;项目 .comate/mcp.json
Vibe Coding · 国内Qoder个人设置 → MCP 服务 → JSON
Vibe Coding · 海外CursorSettings → MCP / .cursor/mcp.json
Vibe Coding · 海外WindsurfCascade → MCP
Vibe Coding · 海外Claude Code项目 MCP 配置
Vibe Coding · 海外ClineVS Code 扩展 MCP
Vibe Coding · 海外Continue~/.continue/config.json
Vibe Coding · 海外Zedsettings.json
通用 MCP 客户端Cherry Studio设置 → MCP 服务器
接入方式说明
/v1/* REST程序集成、用户中心沙箱
llms-full.txt让 AI 读懂参数与错误码
/mcp在已配置 MCP 的客户端里自动调工具查数据

MCP 工具

工具说明
get_realtime实时行情(个股/指数;可选 include_valuation;ETF 用 get_etf_realtime)
get_trend / get_kline分时、K 线
get_stock / search_stocks股票信息
get_corp / get_calendar公司资料、交易日历
get_limit_up涨停数据(实时)
get_abnormal_events个股/板块异动历史
get_my_permissions当前 Key 权限摘要
get_etf*ETF 专用(Pro+)

配置后重启或刷新各客户端的 MCP 连接,在对话中提问即可,例如:「查 600519.SS 最近 20 根日 K」。

AI / 开发者文档

资源路径
完整 Markdown/llms-full.txt/public/v1/docs.md
短索引/llms.txt
MCPhttp://data.klineshare.cn/mcp(远程 Streamable HTTP)

需要模型理解接口:添加 /llms-full.txt 为上下文。需要自动查数:按上文配置 /mcp