Skip to main content
Glama
1018053166

stock-mcp-server

by 1018053166

股票信息查询MCP服务 📈

从东方财富网实时爬取股票数据的MCP服务,支持实时行情、K线、排行榜、股东数据等多种功能。

✨ 功能特性

实时行情

  • ✅ 单只股票实时数据查询

  • ✅ 批量股票数据获取

  • ✅ 股票搜索(代码/名称)

K线数据

  • ✅ 日K/周K/月K线

  • ✅ 1/5/15/30/60分钟线

  • ✅ 自定义数据量

市场分析

  • ✅ 涨跌幅排行榜

  • ✅ 行业板块排行

  • ✅ 市场概况(沪深指数)

股东数据

  • ✅ 股东人数历史变化

  • ✅ 十大流通股东

  • ✅ 股东增长趋势分析

  • ✅ 股东结构分析(散户占比、散户市值比)

Related MCP server: A股实时行情MCP服务器

🚀 快速开始

方式一:直接使用 npx(推荐)

无需安装,直接在MCP客户端配置中使用:

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

方式二:本地安装开发

1. 克隆项目

git clone https://github.com/1018053166/stock-mcp-server.git
cd stock-mcp-server

2. 安装依赖

npm install

3. 启动服务

npm start

4. 配置MCP客户端

{
  "mcpServers": {
    "stock-server": {
      "command": "node",
      "args": ["src/index.js"],
      "cwd": "/path/to/your/stock-mcp-server"
    }
  }
}

⚠️ 注意:请将 /path/to/your/stock-mcp-server 替换为你的实际项目路径

📚 API工具列表

1. get_stock_realtime

获取股票实时行情数据

参数:

  • stockCode (string): 股票代码,如 "000001", "600000"

返回数据:

{
  "stockCode": "000001",
  "stockName": "平安银行",
  "currentPrice": 12.50,
  "changePercent": 1.50,
  "changeAmount": 0.18,
  "openPrice": 12.35,
  "highPrice": 12.60,
  "lowPrice": 12.30,
  "volume": 125000,
  "turnover": 1550000,
  "amplitude": 2.43,
  "turnoverRate": 0.85,
  "pe": 5.20,
  "pb": 0.65
}

2. batch_get_stocks

批量获取多只股票数据

参数:

  • stockCodes (array): 股票代码数组,如 ["000001", "600000"]

3. search_stock

搜索股票

参数:

  • keyword (string): 股票代码或名称关键词

4. get_kline

获取K线数据

参数:

  • stockCode (string): 股票代码

  • period (string): 周期类型

    • 101: 日K线

    • 102: 周K线

    • 103: 月K线

    • 1: 1分钟

    • 5: 5分钟

    • 15: 15分钟

    • 30: 30分钟

    • 60: 60分钟

  • count (number): 获取数量,默认100

5. get_rank_list

获取涨跌幅排行榜

参数:

  • type (string): up-涨幅榜 / down-跌幅榜,默认up

  • count (number): 获取数量,默认20

6. get_sector_rank

获取行业板块排行

参数:

  • count (number): 获取数量,默认20

7. get_market_overview

获取市场概况

返回上证指数、深证成指、创业板指三大指数实时数据

8. get_shareholder_count

获取股东人数数据

参数:

  • stockCode (string): 股票代码

返回数据:

{
  "stockCode": "000001",
  "shareholderData": [
    {
      "endDate": "2024-03-31",
      "holderNum": 685234,
      "holderNumChange": 12345,
      "holderNumChangeRate": 1.83,
      "avgHoldingAmount": 45678.90
    }
  ],
  "latestHolderNum": 685234,
  "latestChange": 12345,
  "latestChangeRate": 1.83
}

9. get_top_ten_holders

获取十大流通股东

参数:

  • stockCode (string): 股票代码

10. get_shareholder_trend

获取股东增长趋势分析

参数:

  • stockCode (string): 股票代码

返回数据:

{
  "stockCode": "000001",
  "trend": "increasing",
  "trendDescription": "持续增长",
  "avgChangeRate": "2.15",
  "analysis": {
    "increasePeriods": 3,
    "decreasePeriods": 1,
    "totalPeriods": 4,
    "latestHolderNum": 685234,
    "latestChange": 12345
  }
}

11. get_money_flow

获取资金流向数据

参数:

  • stockCode (string): 股票代码

返回数据:

{
  "stockCode": "000001",
  "mainNetInflow": 123456.78,
  "mainNetInflowRate": 5.23,
  "superLargeNetInflow": 80000.00,
  "largeNetInflow": 43456.78,
  "mediumNetInflow": -20000.00,
  "smallNetInflow": -15000.00
}

12. get_finance_data

获取财务数据

参数:

  • stockCode (string): 股票代码

**返回数据:**包含营收、净利润、ROE等核心财务指标

13. get_technical_indicators

获取技术指标

参数:

  • stockCode (string): 股票代码

  • days (number): 计算天数,默认60

**返回数据:**包含MA均线、MACD、RSI、KDJ、BOLL等技术指标

14. get_shareholder_structure

获取股东结构数据(散户占比、散户市值比)

参数:

  • stockCode (string): 股票代码

返回数据:

{
  "stockCode": "000001",
  "latestData": {
    "endDate": "2024-03-31",
    "retailHolderRatio": 99.85,
    "retailHoldingAmountRatio": 23.45,
    "institutionHolderRatio": 0.15,
    "institutionHoldingAmountRatio": 76.55,
    "totalHolderNum": 685234,
    "avgHoldingAmount": 45678.90
  },
  "shareholderStructure": [
    {
      "endDate": "2024-03-31",
      "retailHolderNum": 684200,
      "retailHolderRatio": 99.85,
      "retailHoldingAmount": 7890000000,
      "retailHoldingAmountRatio": 23.45,
      "institutionHolderNum": 1034,
      "institutionHolderRatio": 0.15,
      "institutionHoldingAmount": 25670000000,
      "institutionHoldingAmountRatio": 76.55
    }
  ]
}

🛠️ 技术栈

  • Node.js - ES Modules

  • @modelcontextprotocol/sdk - MCP协议实现

  • axios - HTTP请求库

  • 东方财富网API - 数据源

📁 项目结构

leecode/
├── src/
│   ├── index.js      # MCP服务器主文件
│   └── fetcher.js    # 股票数据爬取模块
├── package.json      # 项目配置
├── mcp-config.json   # MCP配置示例
└── README.md         # 说明文档

⚠️ 注意事项

  1. 请合理使用API,避免频繁请求导致IP被封

  2. 批量查询会在请求之间自动延迟200ms

  3. 数据来源于东方财富网,仅供参考,不构成投资建议

  4. 股东数据使用SECUCODE格式(如"000001.SZ"),系统会自动处理

📝 使用示例

在支持MCP的客户端中(如Claude Desktop),可以直接调用工具:

帮我查询平安银行的实时行情
获取贵州茅台最近100天的日K线
显示今天涨幅前20的股票
分析宁德时代的股东增长趋势

🔄 更新日志

v1.1.0 (2026-01-08)

  • ✅ 新增股东结构分析(散户占比、散户市值比)

  • ✅ 新增资金流向数据

  • ✅ 新增财务数据查询

  • ✅ 新增技术指标计算

v1.0.0 (2025-12-26)

  • ✅ 实现基础实时行情查询

  • ✅ 添加K线数据支持

  • ✅ 添加排行榜功能

  • ✅ 添加股东数据分析

  • ✅ 移除数据库依赖,纯实时查询

📄 License

MIT

🤝 贡献

欢迎提交Issue和Pull Request!

📧 联系方式

如有问题或建议,欢迎联系。

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.

Related MCP Servers

  • F
    license
    -
    quality
    C
    maintenance
    MCP server that wraps SFC financial data API into 32 tools for comprehensive A-share market data, including real-time quotes, rankings, limit-up statistics, news, themes, financials, charts, research reports, and watchlists.
  • A
    license
    -
    quality
    D
    maintenance
    Production-grade MCP server for Chinese A-share market data, offering 30 tools including real-time quotes, K-lines, fund flows, and financial reports, with stdio and HTTP transport support.
    6
    MIT
  • F
    license
    -
    quality
    F
    maintenance
    A China fund & stock data MCP server powered by EastMoney free API, enabling querying of fund and stock data without API keys.
    10

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

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/1018053166/stock-mcp-server'

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