把股票数据能力接进 AI：stock-sdk-mcp 的实践整理

起因如果你经常用 Cursor、Claude 这类 AI 工具应该已经能明显感觉到它们在通用问答和代码任务上越来越强了。但一旦问题变成金融数据查询比如“看看贵州茅台今天的行情”“把最近 60 个交易日的日 K 线拉出来再判断一下 MACD 和 RSI”大多数 AI 客户端还是会露出短板。问题通常不在模型理解能力而在数据接入层。很多 AI 工具缺少稳定的股票行情数据源即便能查到一点信息也往往缺少技术指标、板块数据、资金流向和批量筛选能力。更进一步的需求例如“找出今天科创板涨幅前十的股票”往往就更难直接完成。这也是我做stock-sdk-mcp的原因。思路并不复杂既然stock-sdk已经把股票数据的采集和封装做好了那就再补一层 MCP 接口让支持 MCP 的 AI 工具可以直接调用这些能力。先用一句话理解 MCPMCP 是 Model Context Protocol可以把它看成 AI 与外部工具之间的一套标准连接方式。谁实现了 MCP ServerAI 就能通过统一协议去调用谁。常见的理解方式是接入文件系统 MCPAI 就能读写本地文件接入数据库 MCPAI 就能查询和操作数据接入stock-sdk-mcpAI 就能直接查行情、拉 K 线、读取板块信息并做技术分析它的价值不在“替代模型”而在“给模型补齐真实世界的数据入口”。这个 MCP Server 解决了什么问题stock-sdk-mcp的定位很明确就是把stock-sdk已有的数据能力暴露给 AI 客户端使用。当前这套服务里核心内容包括 32 个 MCP 工具和 7 个资源。实际使用时并不需要记工具名直接用自然语言提问即可AI 会自己选择合适的调用路径。例如下面这些问题都可以直接问帮我查一下腾讯控股和比亚迪今天的行情 拉一下贵州茅台最近三个月的日 K 线并计算 MACD 和 RSI 今天表现最强的行业板块是什么 人工智能概念包含哪些成分股 苹果公司最近的 RSI 到了什么位置是否接近超买从能力维度看它主要覆盖了几类场景。1. 行情查询可以查询 A 股、港股、美股和基金的实时行情也支持按名称、代码或拼音做模糊搜索。也就是说很多时候你不需要先记住证券代码直接输入“茅台”或“腾讯”就行。除了单只证券查询也支持大范围批量拉取数据。例如一次性获取数千只 A 股、港股或美股的行情用来做全市场扫描和排序。2. K 线与技术指标支持日线、周线、月线也支持分钟级别 K 线例如 1 分钟、5 分钟、15 分钟、30 分钟和 60 分钟还可以读取当日分时走势。这部分最关键的接口是get_kline_with_indicators。相比只返回开盘价、最高价、最低价、收盘价的普通 K 线接口它会直接把均线、MACD、RSI、KDJ 等指标一并算好再返回。这样做的好处很实际大模型在浮点运算、长序列指标计算这类任务上并不稳定提前把指标算好AI 只负责理解和解释结果会更可靠。3. 板块、搜索与扩展数据行业板块、概念板块、板块成分股、交易日历、资金流向、大单占比、分红明细等能力也都能通过 MCP 暴露给 AI 使用。除了工具调用之外还有 7 个资源可以被 AI 主动读取。这类资源更适合承载相对稳定的辅助信息例如市场代码列表、板块列表和交易日历等。三分钟就能接起来如果你已经在用支持 MCP 的客户端接入这套服务基本不需要额外安装过程直接在配置里通过npx启动即可。常见配置文件位置如下工具配置文件Cursor~/.cursor/mcp.jsonClaude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonAntigravity (Gemini in VS Code)~/.antigravity/mcp.jsonCodex CLI~/.codex/config.jsonGemini CLI~/.gemini/settings.jsonOpenClaw~/.clawdbot/config.yaml对于大多数基于 JSON 的 MCP 配置核心内容都类似{ mcpServers: { stock-sdk: { command: npx, args: [-y, stock-sdk-mcp] } } }保存后重启对应的 AI 工具然后可以直接测试帮我查一下贵州茅台今天的行情如果返回结果里已经有价格、涨跌幅、成交量这类实时字段说明这条链路已经打通。为什么这个接口对 AI 更友好很多人第一次接触时容易把它理解成“给 AI 增加了一个股票查询插件”。但真正有价值的地方不只是能把数据拉出来而是把 AI 不擅长的部分提前处理掉。以技术分析为例模型当然可以自己拿原始 K 线去推导 MA、MACD、RSI、KDJ可一旦数据量变大或者指标组合变复杂分析质量和稳定性就会明显波动。get_kline_with_indicators的思路是把这一步前置到 SDK 层完成。AI 收到的不是裸数据而是已经包含这些字段的结果ma5ma20macd_difmacd_dearsikdj_kkdj_d这样模型只需要专注于解释趋势、判断信号和组织分析结论而不是去硬算技术指标。4 个内置 Skills重点不在查数据而在组织分析流程如果只有工具没有流程AI 的表现通常不够稳定。有时它会把分析写得很完整有时又会遗漏掉关键指标或者判断顺序混乱。所以在工具层之外我又补了 4 个内置 Skill。它们的作用是把多次工具调用串成一套相对固定的分析方法。1. 股票技术分析专家这是最常用的一个 Skill。用户只需要说“分析一下某只股票的技术走势”AI 就会按预设流程完成先读取实时行情确认当前价格和当日涨跌情况获取带指标的日 K 数据判断均线结构和趋势方向检查 MACD 的位置和柱体变化结合 KDJ、RSI 判断超买或超卖状态观察布林带位置与带宽变化输出一份结构化技术分析结果最终结果通常会包含趋势判断、指标状态、风险提示和一个简短结论比单次自由发挥式回答稳定得多。2. 智能股票筛选器这个 Skill 适合处理带条件的选股需求例如找出今天科创板涨幅前 10并且市盈率低于 50 的股票AI 会先识别筛选范围再拉取批量行情数据接着做条件过滤和排序最后返回符合要求的标的。3. 市场深度概览如果问题是“今天市场强不强”“热点主要集中在哪些方向”这个 Skill 会更合适。它会自动汇总主要指数表现、行业板块涨跌、概念板块热度等信息生成一份适合开盘观察或收盘复盘的摘要。4. 自选股实时监控这个 Skill 更接近个人持仓助手。比如你输入买入价和持仓标的AI 可以直接拉实时行情计算浮盈浮亏并补充一些基础走势判断。适合快速查看“手上的票今天整体什么状态”而不是只看单个标的。接到 OpenClaw 之后能力就不只局限在聊天窗口里了OpenClaw 可以把多个 MCP Server 聚合在一起再通过 HTTP API 对外提供统一入口。对stock-sdk-mcp来说这一步的意义是把股票数据能力从单一客户端扩展到任意应用。先在~/.clawdbot/config.yaml里注册服务servers: stock-sdk: command: npx args: - -y - stock-sdk-mcp description: 股票行情数据服务 tags: - finance - stock启动网关clawdbot gateway start之后就可以直接通过 HTTP 接口调用工具。查询行情curl -X POST http://localhost:8080/v1/tools/call \ -H Content-Type: application/json \ -d { server: stock-sdk, tool: get_quotes_by_query, arguments: { queries: [茅台, 腾讯] } }获取带指标的 K 线curl -X POST http://localhost:8080/v1/tools/call \ -H Content-Type: application/json \ -d { server: stock-sdk, tool: get_kline_with_indicators, arguments: { symbol: 600519, indicators: { ma: { periods: [5, 10, 20] }, macd: true } } }如果还想把 Skills 一起带上可以在配置里补充目录skills: directories: - /你的路径/stock-sdk-mcp/skills这样一来你不只是在 Cursor 或 Claude 里提问也可以把这套能力接到自己的服务里。比较适合的场景包括用定时任务在收盘后自动生成复盘报告再推送到飞书、钉钉或微信搭一个简单的 Web 页面让用户输入条件后由 AI 返回候选股票给已有的聊天机器人或 Agent 系统补一层股票数据能力把股票数据、文件系统、邮件等多个 MCP Server 组合在一起交给 AI 编排工作流还有哪些客户端能直接接除了 Cursor 和 Claude Desktop只要工具本身支持 MCP这套服务通常都能接进去。比较常见的包括CursorClaude DesktopAntigravityCodex CLIGemini CLIOpenClaw其中像 Codex CLI 或 Gemini CLI 这类命令行工具也可以直接利用这套能力发起查询。例如在终端里输入查询指令后由客户端通过 MCP 去拉股票数据。这套方案的边界也很明确虽然用起来方便但它并不适合所有金融场景。数据源来自公开接口通常是秒级延迟不适合高频或超低延时交易目前重点覆盖的是行情和相关市场数据财报、公告、新闻等信息暂时不在这套能力里AI 能做的是读取数据、组合信息和辅助分析并不意味着它真的具备交易判断能力所以如果把它当成一个高效的数据助手和分析辅助工具它的价值很直接如果把它当成投资顾问那就超出它的合理边界了。相关链接stock-sdk GitHubstock-sdk 官方文档stock-sdk MCP 文档stock-sdk-mcp NPM 包stock-sdk NPM 包stock-sdk PlaygroundStock Dashboard 演示如果你想本地安装stock-sdk命令如下npm install stock-sdk或者yarn add stock-sdk如果你只是想把 MCP 服务接入客户端通常不需要先安装包直接使用下面这段配置即可{ mcpServers: { stock-sdk: { command: npx, args: [-y, stock-sdk-mcp] } } }收尾从stock-sdk到stock-sdk-mcp本质上是在做一件很朴素的事让 AI 真正拿到可用、实时、结构化的数据再把理解和表达的部分交给模型去完成。我现在越来越倾向于把 MCP 看成一层能力拼装接口。模型本身负责理解问题外部系统负责提供事实和执行能力两边分工清晰反而更容易做出真正有用的工具。如果你本来就在使用支持 MCP 的 AI 客户端不妨把stock-sdk-mcp接上试试。配置本身很短但一旦能直接在 AI 对话里完成行情查询、技术分析和市场扫描工作方式会明显顺手很多。如果觉得有帮助欢迎去 stock-sdk GitHub 给个 Star 支持一下。您的支持是我更新、维护下去的唯一动力。