Skip to content
Back to search

stock-sdk-mcp

股票行情 MCP + Skills 完整解决方案,支持 OpenClaw、Cursor、Claude Desktop、Antigravity、Gemini/Codex CLI 等主流 AI 工具。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chengzuopeng--stock-sdk-mcp/badge.svg)](/listings/chengzuopeng--stock-sdk-mcp)

HTML

<a href="/listings/chengzuopeng--stock-sdk-mcp"><img src="/api/listings/chengzuopeng--stock-sdk-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 463 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Stock SDK MCP Server
  2. <p align="center">
  3. <img src="https://img.shields.io/npm/v/stock-sdk-mcp" alt="npm version">
  4. <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen" alt="node version">
  5. <img src="https://img.shields.io/badge/OpenClaw-Compatible-orange" alt="OpenClaw Compatible">
  6. <img src="https://img.shields.io/badge/protocol-MCP-blue" alt="MCP Protocol">
  7. <img src="https://img.shields.io/badge/license-ISC-green" alt="license">
  8. </p>
  9. > **为 [OpenClaw](https://github.com/anthropics/clawdbot) 生态研发的股票行情 MCP + Skills 完整解决方案**
  10. 基于 [stock-sdk](https://www.npmjs.com/package/stock-sdk) 构建,本项目不仅提供底层的 **MCP (Model Context Protocol) Server**,还内置了一套专业的 **AI Skills (量化技能)** 和 **MCP Prompts**。它能让你的 AI 助手(如 Cursor、Claude、OpenClaw 等)瞬间化身为具备实时数据、技术分析和策略筛选能力的"顶级金融顾问"。
  11. 支持 **OpenClaw**、**Cursor**、**Claude Desktop**、**Antigravity**、**Gemini/Codex CLI** 等主流 AI 工具。
  12. ## ✨ 特性
  13. | 特性 | 描述 |
  14. |------|------|
  15. | 🌐 **多市场支持** | A 股(含沪深北、科创/创业板)、港股、美股(纳斯达克/纽交所/美交所)、公募基金 |
  16. | 📊 **实时行情** | 获取最新价、涨跌幅、成交量、五档盘口、市盈率等 40+ 字段 |
  17. | 📈 **K 线数据** | 日/周/月 K 线,以及 1/5/15/30/60 分钟级别 K 线 |
  18. | 🧮 **技术指标** | 内置 MA/MACD/BOLL/KDJ/RSI/WR/BIAS/CCI/ATR 等常用指标计算 |
  19. | 🏷️ **板块数据** | 行业板块、概念板块的行情、成分股、分钟 K 线 |
  20. | 📦 **期货数据** | 国内/全球期货行情、K 线、仓单库存、COMEX 库存 |
  21. | 📋 **期权数据** | 指数/ETF/商品期权报价、K 线、中金所期权、龙虎榜 |
  22. | 💰 **扩展功能** | 资金流向、分红详情、交易日历、盘口大单 |
  23. | 🚀 **批量查询** | 全市场行情一次性获取(5000+ A 股、2000+ 港股、8000+ 美股) |
  24. | 🔮 **复合分析** | 个股全景分析、多股对比、条件选股、大盘概览、板块深度分析 |
  25. | 💬 **MCP Prompts** | 内置股票分析师、选股器、大盘概览、持仓监控、期货概览等预设 Prompt |
  26. | 📐 **Resource Templates** | 参数化资源模板,通过 URI 直接读取行情和 K 线数据 |
  27. | 🏷️ **Tool Annotations** | 所有工具标注了 readOnlyHint、openWorldHint 等语义信息 |
  28. ## 📦 安装方式
  29. ### 方式一:npx 直接运行(推荐)
  30. 无需安装,在配置文件中直接使用 `npx`:
  31. ```json
  32. {
  33. "mcpServers": {
  34. "stock-sdk": {
  35. "command": "npx",
  36. "args": ["-y", "stock-sdk-mcp"]
  37. }
  38. }
  39. }
  40. ```
  41. ### 方式二:全局安装
  42. ```bash
  43. npm install -g stock-sdk-mcp
  44. ```
  45. 安装后可直接运行 `stock-mcp` 命令。
  46. ### 方式三:本地开发安装
  47. ```bash
  48. git clone https://github.com/chengzuopeng/stock-sdk-mcp.git
  49. cd stock-sdk-mcp
  50. yarn install
  51. yarn build
  52. ```
  53. 或使用一键安装脚本:
  54. ```bash
  55. ./install.sh
  56. ```
  57. ---
  58. ## 🔧 AI 工具配置指南
  59. ### OpenClaw(推荐)
  60. > 🎯 本项目专为 OpenClaw 生态设计,提供开箱即用的股票行情数据能力。
  61. [OpenClaw](https://github.com/anthropics/clawdbot) 是一个开源的 MCP 网关,支持将多个 MCP Server 聚合为统一服务,可通过 HTTP API 在任意应用中调用。
  62. #### 1. 在 OpenClaw 配置中注册此 MCP Server
  63. 编辑 `~/.clawdbot/config.yaml`:
  64. ```yaml
  65. servers:
  66. stock-sdk:
  67. command: npx
  68. args:
  69. - "-y"
  70. - "stock-sdk-mcp"
  71. description: "股票行情数据服务 - 支持 A股/港股/美股实时行情和技术分析"
  72. tags:
  73. - finance
  74. - stock
  75. - market-data
  76. ```
  77. #### 2. 启动 OpenClaw 网关
  78. ```bash
  79. clawdbot gateway start
  80. ```
  81. #### 3. 通过 HTTP API 调用
  82. ```bash
  83. # 查询股票实时行情
  84. curl -X POST http://localhost:8080/v1/tools/call \
  85. -H "Content-Type: application/json" \
  86. -d '{
  87. "server": "stock-sdk",
  88. "tool": "get_quotes_by_query",
  89. "arguments": {
  90. "queries": ["茅台", "腾讯"]
  91. }
  92. }'
  93. # 获取带技术指标的 K 线
  94. curl -X POST http://localhost:8080/v1/tools/call \
  95. -H "Content-Type: application/json" \
  96. -d '{
  97. "server": "stock-sdk",
  98. "tool": "get_kline_with_indicators",
  99. "arguments": {
  100. "symbol": "600519",
  101. "indicators": {"ma": {"periods": [5, 10, 20]}, "macd": true}
  102. }
  103. }'
  104. ```
  105. 这样,你可以在任何支持 HTTP 调用的应用中使用股票数据能力。
  106. ---
  107. ### Cursor IDE
  108. 配置文件路径:`~/.cursor/mcp.json`
  109. ```json
  110. {
  111. "mcpServers": {
  112. "stock-sdk": {
  113. "command": "npx",
  114. "args": ["-y", "stock-sdk-mcp"]
  115. }
  116. }
  117. }
  118. ```
  119. 配置完成后,重启 Cursor 即可在对话中使用股票查询能力。
  120. ---
  121. ### Claude Desktop
  122. 配置文件路径:
  123. - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
  124. - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
  125. ```json
  126. {
  127. "mcpServers": {
  128. "stock-sdk": {
  129. "command": "npx",
  130. "args": ["-y", "stock-sdk-mcp"]
  131. }
  132. }
  133. }
  134. ```
  135. ---
  136. ### Antigravity(Gemini Pro in VS Code)
  137. 配置文件路径:`~/.antigravity/mcp.json`
  138. ```json
  139. {
  140. "mcpServers": {
  141. "stock-sdk": {
  142. "command": "npx",
  143. "args": ["-y", "stock-sdk-mcp"]
  144. }
  145. }
  146. }
  147. ```
  148. ---
  149. ### Codex CLI(OpenAI)
  150. 配置文件路径:`~/.codex/config.json`
  151. ```json
  152. {
  153. "mcpServers": {
  154. "stock-sdk": {
  155. "command": "npx",
  156. "args": ["-y", "stock-sdk-mcp"]
  157. }
  158. }
  159. }
  160. ```
  161. ---
  162. ### Gemini CLI(Google)
  163. 配置文件路径:`~/.gemini/settings.json`
  164. ```json
  165. {
  166. "mcpServers": {
  167. "stock-sdk": {
  168. "command": "npx",
  169. "args": ["-y", "stock-sdk-mcp"]
  170. }
  171. }
  172. }
  173. ```
  174. ---
  175. ## 🛠️ 可用 Tools
  176. ### 实时行情
  177. | Tool | 描述 |
  178. |------|------|
  179. | `get_quotes_by_query` | **【推荐】** 按名称、代码或拼音获取行情,自动识别 A股/港股/美股 |
  180. | `get_a_share_quotes` | 获取 A 股/指数实时行情(40+ 字段) |
  181. | `get_hk_quotes` | 获取港股实时行情 |
  182. | `get_us_quotes` | 获取美股实时行情 |
  183. | `get_fund_quotes` | 获取公募基金实时净值 |
  184. | `get_all_a_share_quotes` | **【批量】** 获取全市场 A 股行情(5000+ 只) |
  185. | `get_all_hk_quotes` | **【批量】** 获取全市场港股行情(2000+ 只) |
  186. | `get_all_us_quotes` | **【批量】** 获取全市场美股行情(8000+ 只) |
  187. ### K 线数据
  188. | Tool | 描述 |
  189. |------|------|
  190. | `get_history_kline` | 获取 A 股历史 K 线(日/周/月) |
  191. | `get_hk_history_kline` | 获取港股历史 K 线 |
  192. | `get_us_history_kline` | 获取美股历史 K 线 |
  193. | `get_minute_kline` | 获取 A 股分钟 K 线(1/5/15/30/60 分钟) |
  194. | `get_today_timeline` | 获取 A 股当日分时走势 |
  195. | `get_kline_with_indicators` | **【重要】** 获取带技术指标的 K 线(MA/MACD/BOLL/KDJ/RSI 等) |
  196. ### 板块数据
  197. | Tool | 描述 |
  198. |------|------|
  199. | `get_industry_list` | 获取行业板块列表 |
  200. | `get_industry_spot` | 获取行业板块实时行情 |
  201. | `get_industry_constituents` | 获取行业板块成分股 |
  202. | `get_industry_kline` | 获取行业板块 K 线(支持复权) |
  203. | `get_industry_minute_kline` | 获取行业板块分钟 K 线/分时 |
  204. | `get_concept_list` | 获取概念板块列表 |
  205. | `get_concept_spot` | 获取概念板块实时行情 |
  206. | `get_concept_constituents` | 获取概念板块成分股 |
  207. | `get_concept_kline` | 获取概念板块 K 线(支持复权) |
  208. | `get_concept_minute_kline` | 获取概念板块分钟 K 线/分时 |
  209. ### 期货数据 🆕
  210. | Tool | 描述 |
  211. |------|------|
  212. | `get_futures_kline` | 获取国内期货历史 K 线(含持仓量) |
  213. | `get_global_futures_spot` | 获取全球期货实时行情(原油、黄金、铜等) |
  214. | `get_global_futures_kline` | 获取全球期货历史 K 线 |
  215. | `get_futures_inventory_symbols` | 获取可查库存的期货品种列表 |
  216. | `get_futures_inventory` | 获取期货仓单/库存数据 |
  217. | `get_comex_inventory` | 获取 COMEX 黄金/白银库存 |
  218. ### 期权数据 🆕
  219. | Tool | 描述 |
  220. |------|------|
  221. | `get_index_option_spot` | 获取指数期权 T 型报价(沪深300/中证1000等) |
  222. | `get_index_option_kline` | 获取指数期权合约日 K 线 |
  223. | `get_cffex_option_quotes` | 获取中金所期权实时行情列表 |
  224. | `get_etf_option_months` | 获取 ETF 期权可用合约月份 |
  225. | `get_etf_option_expire_day` | 获取 ETF 期权到期日信息 |
  226. | `get_etf_option_minute` | 获取 ETF 期权合约分时数据 |
  227. | `get_etf_option_daily_kline` | 获取 ETF 期权合约日 K 线 |
  228. | `get_commodity_option_spot` | 获取商品期权 T 型报价 |
  229. | `get_commodity_option_kline` | 获取商品期权合约日 K 线 |
  230. | `get_option_lhb` | 获取期权龙虎榜数据 |
  231. ### 复合分析工具 🆕
  232. | Tool | 描述 |
  233. |------|------|
  234. | `analyze_stock` | **【复合】** 个股全景分析(行情+K线+指标+资金流+分红) |
  235. | `compare_stocks` | **【复合】** 多股对比分析(2-10 只股票并排对比) |
  236. | `scan_market` | **【复合】** 条件选股(涨跌幅/量比/换手率/市盈率等过滤) |
  237. | `get_market_overview` | **【复合】** 大盘概览(指数+行业TOP10+概念TOP10+涨跌统计) |
  238. | `get_sector_analysis` | **【复合】** 板块深度分析(行情+K线+龙头股) |
  239. ### 代码列表
  240. | Tool | 描述 |
  241. |------|------|
  242. | `get_a_share_code_list` | 获取全部 A 股代码(5000+ 只) |
  243. | `get_hk_code_list` | 获取全部港股代码(2000+ 只) |
  244. | `get_us_code_list` | 获取全部美股代码(8000+ 只) |
  245. | `get_fund_code_list` | 获取全部基金代码(26000+ 只) |
  246. ### 搜索
  247. | Tool | 描述 |
  248. |------|------|
  249. | `search_stock` | 搜索股票(支持代码、名称、拼音模糊匹配) |
  250. ### 扩展功能
  251. | Tool | 描述 |
  252. |------|------|
  253. | `get_fund_flow` | 获取个股/板块资金流向 |
  254. | `get_panel_large_order` | 获取盘口大单占比 |
  255. | `get_trading_calendar` | 获取 A 股交易日历 |
  256. | `get_dividend_detail` | 获取分红派送详情 |
  257. ---
  258. ## 💬 MCP Prompts 🆕
  259. 内置预设 Prompt,所有支持 MCP 的 AI 客户端均可直接使用:
  260. | Prompt | 描述 | 参数 |
  261. |--------|------|------|
  262. | `stock-analyst` | 个股技术分析专家 | `symbol`(必填), `period` |
  263. | `stock-screener` | 智能选股器 | `conditions`(必填), `market` |
  264. | `market-overview` | 大盘全景概览 | `scope` |
  265. | `realtime-monitor` | 自选股实时监控 | `stocks`(必填), `costs` |
  266. | `futures-overview` | 期货市场概览 | `scope` |
  267. ---
  268. ## 🧠 AI Skills (技能)
  269. Skills 是一组预定义的"场景化指令",将多个 MCP Tools 组合成专业的工作流。本项目专为 **OpenClaw** 提供了开箱即用的技能支持。
  270. | Skill | 描述 | 包含步骤 |
  271. |-------|------|----------|
  272. | [股票技术分析专家](./skills/stock-analyst/SKILL.md) | 深度分析 K 线形态与指标 | 行情查询 -> 历史 K 线 -> 指标计算 (MACD/RSI/BOLL) -> 综合诊断 |
  273. | [智能股票筛选器](./skills/stock-screener/SKILL.md) | 按策略筛选全市场标的 | 范围定位 (如科创板) -> 批量数据获取 -> 条件过滤 -> 排序输出 |
  274. | [市场深度概览](./skills/market-overview/SKILL.md) | 快速把握全局行情 | 指数汇总 -> 行业/概念板块排名 -> 情绪评估 -> 简评报告 |
  275. | [自选股实时监控](./skills/realtime-monitor/SKILL.md) | 持续跟踪并计算损益 | 批量行情监控 -> 异动检测 -> 持仓成本对比 -> 价格提醒 |
  276. #### 💬 技能使用示例:
  277. - **技术分析**:"分析一下**腾讯**最近的走势,帮我看看 **MACD** 什么时候金叉?"
  278. - **策略筛选**:"帮我找出今天**科创板**里涨幅前 10 且**市盈率**低于 50 的股票。"
  279. - **市场全局**:"现在**盘面表现**如何?有哪些**热门概念**值得关注?"
  280. - **损益监控**:"查一下我的持仓:**茅台**买入价 1400,**美团**买入价 120。"
  281. > 💡 关于如何在 OpenClaw、Cursor 等工具中使用这些技能,请参阅 [Skills 使用指南](./skills/README.md)。
  282. ---
  283. ## 📚 可用 Resources
  284. ### 静态资源
  285. MCP Resources 是静态数据资源,可供 AI 主动读取:
  286. | URI | 描述 |
  287. |-----|------|
  288. | `stock://calendar/trading` | A 股交易日历 |
  289. | `stock://market/a-share/codes` | A 股代码列表 |
  290. | `stock://market/hk/codes` | 港股代码列表 |
  291. | `stock://market/us/codes` | 美股代码列表 |
  292. | `stock://market/fund/codes` | 基金代码列表 |
  293. | `stock://board/industry/list` | 行业板块列表 |
  294. | `stock://board/concept/list` | 概念板块列表 |
  295. ### Resource Templates 🆕
  296. 参数化资源模板,通过 URI 直接读取动态数据:
  297. | URI Template | 描述 | 示例 |
  298. |-------------|------|------|
  299. | `stock://quotes/{code}` | 个股实时行情 | `stock://quotes/sh600519` |
  300. | `stock://kline/{code}/{period}` | 个股 K 线数据 | `stock://kline/600519/daily` |
  301. | `stock://board/industry/{code}` | 行业板块详情 | `stock://board/industry/BK1027` |
  302. | `stock://board/concept/{code}` | 概念板块详情 | `stock://board/concept/BK0800` |
  303. ---
  304. ## 💡 使用示例
  305. 配置完成后,你可以在 AI 对话中直接输入:
  306. ```
  307. 请帮我查询贵州茅台(600519)的实时行情
  308. 获取腾讯控股(00700)最近 30 天的日 K 线,并计算 MACD 和布林带
  309. 查看人工智能概念板块有哪些成分股,以及今天涨幅前 5 的股票
  310. 获取全市场科创板股票的实时行情,按涨幅排序
  311. 苹果公司最近的 RSI 指标是多少?是否超买?
  312. 帮我看看螺纹钢主力合约最近的走势
  313. 全球黄金期货现在什么价位?COMEX 库存最近变化如何?
  314. 帮我用 scan_market 找出今天换手率大于 10% 且涨幅大于 5% 的股票
  315. ```
  316. ---
  317. ## 🧑‍💻 本地开发
  318. ```bash
  319. # 安装依赖
  320. yarn install
  321. # 开发模式(监听文件变化自动重新构建)
  322. yarn dev
  323. # 构建生产版本
  324. yarn build
  325. # 运行服务
  326. yarn start
  327. # 运行测试
  328. yarn test
  329. ```
  330. ### 调试 MCP Server
  331. 你可以通过管道发送 JSON-RPC 消息来测试:
  332. ```bash
  333. echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_quotes_by_query", "arguments": {"queries": ["茅台"]}}}' | node dist/index.js
  334. ```
  335. ---
  336. ## 📄 License
  337. ISC © [chengzuopeng](https://github.com/chengzuopeng/stock-sdk-mcp)
  338. ---
  339. ## 🔗 相关链接
  340. - [OpenClaw](https://github.com/anthropics/clawdbot) - MCP 网关
  341. - [stock-sdk](https://www.npmjs.com/package/stock-sdk) - 核心 SDK 库
  342. - [MCP Protocol](https://modelcontextprotocol.io) - Model Context Protocol 官方文档
  343. - [Cursor](https://cursor.sh) - AI 代码编辑器
  344. - [Claude Desktop](https://claude.ai/download) - Anthropic 桌面客户端

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.