Skip to main content
Glama
chengzuopeng

Stock SDK MCP Server

by chengzuopeng

Stock SDK MCP Server

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

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

支持 OpenClawCursorClaude DesktopAntigravityGemini/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 等语义信息

Related MCP server: deepq-financial-toolkit

📦 安装方式

方式一:npx 直接运行(推荐)

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

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

方式二:全局安装

npm install -g stock-sdk-mcp

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

方式三:本地开发安装

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

或使用一键安装脚本:

./install.sh

🔧 AI 工具配置指南

OpenClaw(推荐)

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

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

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

编辑 ~/.clawdbot/config.yaml

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

2. 启动 OpenClaw 网关

clawdbot gateway start

3. 通过 HTTP API 调用

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

{
  "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

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

Antigravity(Gemini Pro in VS Code)

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

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

Codex CLI(OpenAI)

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

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

Gemini CLI(Google)

配置文件路径:~/.gemini/settings.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 对话中直接输入:

请帮我查询贵州茅台(600519)的实时行情

获取腾讯控股(00700)最近 30 天的日 K 线,并计算 MACD 和布林带

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

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

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

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

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

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

🧑‍💻 本地开发

# 安装依赖
yarn install

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

# 构建生产版本
yarn build

# 运行服务
yarn start

# 运行测试
yarn test

调试 MCP Server

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

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

📄 License

ISC © chengzuopeng


🔗 相关链接

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chengzuopeng/stock-sdk-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server