股票信息查询MCP服务 📈

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

✨ 功能特性

实时行情

• ✅ 单只股票实时数据查询
• ✅ 批量股票数据获取
• ✅ 股票搜索（代码/名称）

K线数据

• ✅ 日K/周K/月K线
• ✅ 1/5/15/30/60分钟线
• ✅ 自定义数据量

市场分析

• ✅ 涨跌幅排行榜
• ✅ 行业板块排行
• ✅ 市场概况（沪深指数）

股东数据

• ✅ 股东人数历史变化
• ✅ 十大流通股东
• ✅ 股东增长趋势分析
• ✅ 股东结构分析（散户占比、散户市值比）

🚀 快速开始

方式一：直接使用 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！

📧 联系方式

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