MCP 接入文档

通过 Model Context Protocol 将 StockClaw 接入 Claude、Cursor 等 AI 工具,直接在对话中查询 A 股数据

什么是 MCP?

Model Context Protocol (MCP) 是 Anthropic 推出的开放协议,允许 AI 模型通过标准接口调用外部工具和数据。 StockClaw 实现了 MCP 服务端,你可以在支持 MCP 的 AI 工具中直接查询股票数据,无需切换应用。

快速开始

1. 获取 API Key

前往 订阅页面 选择计划,支付后系统自动生成 API Key,通常 30 秒内即可使用。

2. 配置 Claude Desktop

打开配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json,添加:

claude_desktop_config.json
{ "mcpServers": { "stockclaw": { "url": "https://api.dkluge.com/mcp/stock-claw", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

3. 配置 Cursor

在 Cursor 设置 → MCP 中添加新服务器:

Cursor MCP 配置
{ "name": "StockClaw", "url": "https://api.dkluge.com/mcp/stock-claw", "headers": { "Authorization": "Bearer YOUR_API_KEY" } }

4. SSE 流式端点

GEThttps://api.dkluge.com/mcp/stock-claw/sse

部分客户端使用 SSE 长连接模式,将 URL 末尾加 /sse 即可。

验证接入

配置完成后,可用以下命令验证 API Key 是否有效、服务是否正常:

终端(替换 YOUR_API_KEY)
curl -s -X POST https://api.dkluge.com/mcp/stock-claw \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | python3 -c "import sys,json; d=json.load(sys.stdin); print('OK — 共', len(d['result']['tools']), '个工具')"

输出 OK — 共 6 个工具 即表示接入成功。

可用工具(6 个)

get_auction_data
获取指定股票的集合竞价数据,包括开盘涨幅、竞价金额、竞价成交量、连板天数、封板比等,帮助分析次日操作策略
codes必填string[]股票代码数组,支持交易所后缀,如 ["000001.SH", "300750"],最多 20 只
date可选string?查询日期(YYYY-MM-DD),不传则取最近涨停日
get_stock_full_info
获取股票完整信息,包含基本面财务数据(PE/PB/ROE/毛利率)、最近行情(含开高低收)、52 周高低位、60 日 K 线、涨停历史、长期均值指标
code必填string股票代码,支持交易所后缀以精准区分同代码股票,如 "000001.SH"(上证指数)或 "000001.SZ"(平安银行);无歧义时直接传代码,如 "600519"
exchange可选string?交易所代码 SH / SZ / BJ,与 code 后缀等效,二选一即可
get_themes_24h
获取过去24小时内活跃的涨停板题材,含市场情绪温度指数、涨停/跌停数量、各题材的连板高度和个股列表
date可选string?查询日期(YYYY-MM-DD),不传则取最近交易日
get_news_summary
获取AI财经日报,包含当日最重要的市场要闻,每条标注涨/跌/中性影响、重要程度(1-5星)及相关题材标签
date可选string?查询日期(YYYY-MM-DD),不传则取最新一期
session可选"morning" | "afternoon"?报告时段:morning=盘前,afternoon=盘后
search_limit_board
搜索历史涨停板数据,支持按板块题材关键词、日期区间、连板天数过滤,每页返回50条
keyword可选string?关键词,匹配板块名称或涨停原因,如 "新能源"、"AI"
date_from可选string?起始日期,格式 YYYY-MM-DD
date_to可选string?截止日期,格式 YYYY-MM-DD
min_days可选number?最小连板天数,如 2 则只返回2板及以上
page可选number?页码,默认1
get_sentiment_history
获取市场情绪历史走势,返回近N日的情绪温度(0-100)、涨停数、跌停数,用于判断市场热度变化趋势
days可选number?查询天数,默认30,最大90

使用示例

配置完成后,你可以直接在 Claude 或 Cursor 中用自然语言提问:

1.今天比亚迪竞价表现如何?开盘涨幅多少?
2.近期新能源板块的涨停个股有哪些?
3.今日市场情绪温度是多少?涨停板数量?
4.获取今天的 AI 财经日报摘要
5.帮我分析贵州茅台的财务指标和52周高低
6.查一下近30天市场情绪走势,最近是热还是冷?

API 协议说明

StockClaw MCP 使用标准 JSON-RPC 2.0 协议,支持以下方法:

初始化
POST https://api.dkluge.com/mcp/stock-claw Authorization: Bearer YOUR_API_KEY Content-Type: application/json { "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2024-11-05", "clientInfo": { "name": "my-client", "version": "1.0.0" } } }
列出工具
{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }
调用工具
{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "get_auction_data", "arguments": { "codes": ["000001.SH", "300750"] } } }

认证方式

所有请求需在请求头中携带 API Key:

请求头
Authorization: Bearer sk_your_api_key_here

API Key 在订阅后自动生成,可在 API 管理 页面查看和管理。一个账户支持多个 Key,可按项目分别创建。

错误码

-32700Parse error
请求 JSON 格式错误
检查请求 body 是否为合法 JSON
-32600Invalid Request
请求结构不合法
确保包含 jsonrpc / id / method 字段
-32601Method not found
调用了不存在的方法
检查 method 名称拼写(如 tools/call)
-32602Invalid params
参数类型或格式错误
codes 应为字符串数组,date 应为 YYYY-MM-DD
-32603Internal error
服务器内部错误
稍后重试;若持续出现请联系支持
-32000Tool error
工具执行失败(数据不存在等)
该股票 / 日期暂无数据,尝试换一个日期
401Unauthorized
API Key 无效、已过期或未提供
检查 Authorization 头格式:Bearer sk_...
股票详情