股票行情获取和分析服务

为 OpenClaw 生态研发的股票行情 MCP Server - 支持 A股/港股/美股实时行情、K线、技术指标。兼容 Cursor、Claude Desktop、Antigravity、Gemini CLI 等主流 AI 工具。

Install

openclaw plugins install clawhub:stock-sdk-mcp

Stock SDK MCP Server

npm version node version OpenClaw Compatible MCP Protocol license

为 OpenClaw 生态研发的股票行情 MCP + Skills 完整解决方案

基于 stock-sdk 构建，本项目不仅提供底层的 MCP (Model Context Protocol) Server，还内置了一套专业的 AI Skills (量化技能) 和 MCP Prompts。它能让你的 AI 助手（如 Cursor、Claude、OpenClaw 等）瞬间化身为具备实时数据、技术分析和策略筛选能力的"顶级金融顾问"。

支持 OpenClaw、Cursor、Claude Desktop、Antigravity、Gemini/Codex CLI 等主流 AI 工具。

✨ 特性

特性	描述
🌐 多市场支持	A 股（含沪深北、科创/创业板）、港股、美股（纳斯达克/纽交所/美交所）、公募基金
📊 实时行情	获取最新价、涨跌幅、成交量、五档盘口、市盈率等 40+ 字段
📈 K 线数据	日/周/月 K 线，以及 1/5/15/30/60 分钟级别 K 线
🧮 技术指标	内置 MA/MACD/BOLL/KDJ/RSI/WR/BIAS/CCI/ATR 等常用指标计算
🏷️ 板块数据	行业板块、概念板块的行情、成分股、分钟 K 线
📦 期货数据	国内/全球期货行情、K 线、仓单库存、COMEX 库存
📋 期权数据	指数/ETF/商品期权报价、K 线、中金所期权、龙虎榜
💰 扩展功能	资金流向、分红详情、交易日历、盘口大单
🚀 批量查询	全市场行情一次性获取（5000+ A 股、2000+ 港股、8000+ 美股）
🔮 复合分析	个股全景分析、多股对比、条件选股、大盘概览、板块深度分析
💬 MCP Prompts	内置股票分析师、选股器、大盘概览、持仓监控、期货概览等预设 Prompt
📐 Resource Templates	参数化资源模板，通过 URI 直接读取行情和 K 线数据
🏷️ Tool Annotations	所有工具标注了 readOnlyHint、openWorldHint 等语义信息

📦 安装方式

方式一：npx 直接运行（推荐）

无需安装，在配置文件中直接使用 npx：

json

{
  "mcpServers": {
    "stock-sdk": {
      "command": "npx",
      "args": ["-y", "stock-sdk-mcp"]
    }
  }
}

方式二：全局安装

bash

npm install -g stock-sdk-mcp

安装后可直接运行 stock-mcp 命令。

方式三：本地开发安装

bash

git clone https://github.com/chengzuopeng/stock-sdk-mcp.git
cd stock-sdk-mcp
yarn install
yarn build

或使用一键安装脚本：

bash

./install.sh

🔧 AI 工具配置指南

OpenClaw（推荐）

🎯 本项目专为 OpenClaw 生态设计，提供开箱即用的股票行情数据能力。

OpenClaw 是一个开源的 MCP 网关，支持将多个 MCP Server 聚合为统一服务，可通过 HTTP API 在任意应用中调用。

1. 在 OpenClaw 配置中注册此 MCP Server

编辑 ~/.clawdbot/config.yaml：

yaml

servers:
  stock-sdk:
    command: npx
    args:
      - "-y"
      - "stock-sdk-mcp"
    description: "股票行情数据服务 - 支持 A股/港股/美股实时行情和技术分析"
    tags:
      - finance
      - stock
      - market-data

2. 启动 OpenClaw 网关

bash

clawdbot gateway start

3. 通过 HTTP API 调用

bash

# 查询股票实时行情
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}
    }
  }'

这样，你可以在任何支持 HTTP 调用的应用中使用股票数据能力。

Cursor IDE

配置文件路径：~/.cursor/mcp.json

json

{
  "mcpServers": {
    "stock-sdk": {
      "command": "npx",
      "args": ["-y", "stock-sdk-mcp"]
    }
  }
}

配置完成后，重启 Cursor 即可在对话中使用股票查询能力。

Claude Desktop

配置文件路径：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "stock-sdk": {
      "command": "npx",
      "args": ["-y", "stock-sdk-mcp"]
    }
  }
}

Antigravity（Gemini Pro in VS Code）

配置文件路径：~/.antigravity/mcp.json

json

{
  "mcpServers": {
    "stock-sdk": {
      "command": "npx",
      "args": ["-y", "stock-sdk-mcp"]
    }
  }
}

Codex CLI（OpenAI）

配置文件路径：~/.codex/config.json

json

{
  "mcpServers": {
    "stock-sdk": {
      "command": "npx",
      "args": ["-y", "stock-sdk-mcp"]
    }
  }
}

Gemini CLI（Google）

配置文件路径：~/.gemini/settings.json

json

{
  "mcpServers": {
    "stock-sdk": {
      "command": "npx",
      "args": ["-y", "stock-sdk-mcp"]
    }
  }
}

🛠️ 可用 Tools

实时行情

Tool	描述
`get_quotes_by_query`	【推荐】按名称、代码或拼音获取行情，自动识别 A股/港股/美股
`get_a_share_quotes`	获取 A 股/指数实时行情（40+ 字段）
`get_hk_quotes`	获取港股实时行情
`get_us_quotes`	获取美股实时行情
`get_fund_quotes`	获取公募基金实时净值
`get_all_a_share_quotes`	【批量】获取全市场 A 股行情（5000+ 只）
`get_all_hk_quotes`	【批量】获取全市场港股行情（2000+ 只）
`get_all_us_quotes`	【批量】获取全市场美股行情（8000+ 只）

K 线数据

Tool	描述
`get_history_kline`	获取 A 股历史 K 线（日/周/月）
`get_hk_history_kline`	获取港股历史 K 线
`get_us_history_kline`	获取美股历史 K 线
`get_minute_kline`	获取 A 股分钟 K 线（1/5/15/30/60 分钟）
`get_today_timeline`	获取 A 股当日分时走势
`get_kline_with_indicators`	【重要】获取带技术指标的 K 线（MA/MACD/BOLL/KDJ/RSI 等）

板块数据

Tool	描述
`get_industry_list`	获取行业板块列表
`get_industry_spot`	获取行业板块实时行情
`get_industry_constituents`	获取行业板块成分股
`get_industry_kline`	获取行业板块 K 线（支持复权）
`get_industry_minute_kline`	获取行业板块分钟 K 线/分时
`get_concept_list`	获取概念板块列表
`get_concept_spot`	获取概念板块实时行情
`get_concept_constituents`	获取概念板块成分股
`get_concept_kline`	获取概念板块 K 线（支持复权）
`get_concept_minute_kline`	获取概念板块分钟 K 线/分时

期货数据 🆕

Tool	描述
`get_futures_kline`	获取国内期货历史 K 线（含持仓量）
`get_global_futures_spot`	获取全球期货实时行情（原油、黄金、铜等）
`get_global_futures_kline`	获取全球期货历史 K 线
`get_futures_inventory_symbols`	获取可查库存的期货品种列表
`get_futures_inventory`	获取期货仓单/库存数据
`get_comex_inventory`	获取 COMEX 黄金/白银库存

期权数据 🆕

Tool	描述
`get_index_option_spot`	获取指数期权 T 型报价（沪深300/中证1000等）
`get_index_option_kline`	获取指数期权合约日 K 线
`get_cffex_option_quotes`	获取中金所期权实时行情列表
`get_etf_option_months`	获取 ETF 期权可用合约月份
`get_etf_option_expire_day`	获取 ETF 期权到期日信息
`get_etf_option_minute`	获取 ETF 期权合约分时数据
`get_etf_option_daily_kline`	获取 ETF 期权合约日 K 线
`get_commodity_option_spot`	获取商品期权 T 型报价
`get_commodity_option_kline`	获取商品期权合约日 K 线
`get_option_lhb`	获取期权龙虎榜数据

复合分析工具 🆕

Tool	描述
`analyze_stock`	【复合】个股全景分析（行情+K线+指标+资金流+分红）
`compare_stocks`	【复合】多股对比分析（2-10 只股票并排对比）
`scan_market`	【复合】条件选股（涨跌幅/量比/换手率/市盈率等过滤）
`get_market_overview`	【复合】大盘概览（指数+行业TOP10+概念TOP10+涨跌统计）
`get_sector_analysis`	【复合】板块深度分析（行情+K线+龙头股）

代码列表

Tool	描述
`get_a_share_code_list`	获取全部 A 股代码（5000+ 只）
`get_hk_code_list`	获取全部港股代码（2000+ 只）
`get_us_code_list`	获取全部美股代码（8000+ 只）
`get_fund_code_list`	获取全部基金代码（26000+ 只）

搜索

Tool	描述
`search_stock`	搜索股票（支持代码、名称、拼音模糊匹配）

扩展功能

Tool	描述
`get_fund_flow`	获取个股/板块资金流向
`get_panel_large_order`	获取盘口大单占比
`get_trading_calendar`	获取 A 股交易日历
`get_dividend_detail`	获取分红派送详情

💬 MCP Prompts 🆕

内置预设 Prompt，所有支持 MCP 的 AI 客户端均可直接使用：

Prompt	描述	参数
`stock-analyst`	个股技术分析专家	`symbol`(必填), `period`
`stock-screener`	智能选股器	`conditions`(必填), `market`
`market-overview`	大盘全景概览	`scope`
`realtime-monitor`	自选股实时监控	`stocks`(必填), `costs`
`futures-overview`	期货市场概览	`scope`

🧠 AI Skills (技能)

Skills 是一组预定义的"场景化指令"，将多个 MCP Tools 组合成专业的工作流。本项目专为 OpenClaw 提供了开箱即用的技能支持。

Skill	描述	包含步骤
股票技术分析专家	深度分析 K 线形态与指标	行情查询 -> 历史 K 线 -> 指标计算 (MACD/RSI/BOLL) -> 综合诊断
智能股票筛选器	按策略筛选全市场标的	范围定位 (如科创板) -> 批量数据获取 -> 条件过滤 -> 排序输出
市场深度概览	快速把握全局行情	指数汇总 -> 行业/概念板块排名 -> 情绪评估 -> 简评报告
自选股实时监控	持续跟踪并计算损益	批量行情监控 -> 异动检测 -> 持仓成本对比 -> 价格提醒

💬 技能使用示例：

技术分析："分析一下腾讯最近的走势，帮我看看 MACD 什么时候金叉？"
策略筛选："帮我找出今天科创板里涨幅前 10 且市盈率低于 50 的股票。"
市场全局："现在盘面表现如何？有哪些热门概念值得关注？"
损益监控："查一下我的持仓：茅台买入价 1400，美团买入价 120。"

💡 关于如何在 OpenClaw、Cursor 等工具中使用这些技能，请参阅 Skills 使用指南。

📚 可用 Resources

静态资源

MCP Resources 是静态数据资源，可供 AI 主动读取：

URI	描述
`stock://calendar/trading`	A 股交易日历
`stock://market/a-share/codes`	A 股代码列表
`stock://market/hk/codes`	港股代码列表
`stock://market/us/codes`	美股代码列表
`stock://market/fund/codes`	基金代码列表
`stock://board/industry/list`	行业板块列表
`stock://board/concept/list`	概念板块列表

Resource Templates 🆕

参数化资源模板，通过 URI 直接读取动态数据：

URI Template	描述	示例
`stock://quotes/{code}`	个股实时行情	`stock://quotes/sh600519`
`stock://kline/{code}/{period}`	个股 K 线数据	`stock://kline/600519/daily`
`stock://board/industry/{code}`	行业板块详情	`stock://board/industry/BK1027`
`stock://board/concept/{code}`	概念板块详情	`stock://board/concept/BK0800`

💡 使用示例

配置完成后，你可以在 AI 对话中直接输入：

text

请帮我查询贵州茅台（600519）的实时行情

获取腾讯控股（00700）最近 30 天的日 K 线，并计算 MACD 和布林带

查看人工智能概念板块有哪些成分股，以及今天涨幅前 5 的股票

获取全市场科创板股票的实时行情，按涨幅排序

苹果公司最近的 RSI 指标是多少？是否超买？

帮我看看螺纹钢主力合约最近的走势

全球黄金期货现在什么价位？COMEX 库存最近变化如何？

帮我用 scan_market 找出今天换手率大于 10% 且涨幅大于 5% 的股票

🧑‍💻 本地开发

bash

# 安装依赖
yarn install

# 开发模式（监听文件变化自动重新构建）
yarn dev

# 构建生产版本
yarn build

# 运行服务
yarn start

# 运行测试
yarn test

调试 MCP Server

你可以通过管道发送 JSON-RPC 消息来测试：

bash

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_quotes_by_query", "arguments": {"queries": ["茅台"]}}}' | node dist/index.js

📄 License

🔗 相关链接

OpenClaw - MCP 网关
stock-sdk - 核心 SDK 库
MCP Protocol - Model Context Protocol 官方文档
Cursor - AI 代码编辑器
Claude Desktop - Anthropic 桌面客户端