Skip to main content

实时股票分析 MCP 服务


这是一个实时股票数据服务的MCP服务器。它通过东方财富网和雪球网获取金融数据,并将这些数据以工具的形式暴露给支持MCP的Agent。

代码仓库: https://github.com/DannyWongIsAvailable/real-time-stock-mcp-service.git

  • 免费免登录获取数据

功能特性

  • 📊 查找股票
  • 📈 K线数据查询(支持B股,H股,大盘,分时图)
  • 📉 技术指标分析 (MA,MACD,BOLL,RSI等等)
  • 💰 基本面数据分析(主营构成、经营范围等)
  • 📊 财务分析(财务比率、业绩概况等)
  • 💰 估值分析数据(市盈率、市净率等)
  • 📈 市场行情跟踪(板块行情、同行对比、资金流向等)
  • 🤖 智能点评和评分

共34个MCP工具

使用方法

您可以通过以下3种方式使用本服务:

1. 魔搭社区免费云资源一键部署

您可以在魔搭社区MCP实验场中在线体验该服务,也支持客户端远程连接(streamable HTTP或SSE协议)

https://modelscope.cn/mcp/servers/DannyWong/real-time-stock-mcp

2. 本地stdio模式(安装软件包运行)

添加以下配置:

{
  "mcpServers": {
    "stock-mcp": {
      "command": "uvx",
      "args": [
        "real-time-stock-mcp-service"
      ],
      "env": {
        "EASTMONEY_COOKIE": "从浏览器复制的东方财富 Cookie",
        "XUEQIU_COOKIE": "从浏览器复制的雪球 Cookie"
      }
    }
  }
}

3. 本地stdio模式(源代码运行)

{
  "mcpServers": {
    "stock-mcp": {
      "command": "path/to/python.exe",
      "args": ["-m", "stock_mcp"],
      "cwd": "path/to/real-time-stock-mcp-service",
      "env": {
        "EASTMONEY_COOKIE": "从浏览器复制的东方财富 Cookie",
        "XUEQIU_COOKIE": "从浏览器复制的雪球 Cookie"
      }
    }
  }
}

注意: 将路径替换为你的实际项目路径。

部分接口(如东方财富 datacenter、雪球实时行情/K 线)需要浏览器 Cookie 才能正常访问。请在 MCP 配置的 env 字段中设置:

环境变量 说明
EASTMONEY_COOKIE 东方财富 Cookie,用于 datacenter、push2 等接口
XUEQIU_COOKIE 雪球 Cookie,用于实时行情、K 线等接口
LOG_LEVEL 可选,日志级别,默认 INFO

获取 Cookie:

  1. 浏览器登录 eastmoney.com 或 xueqiu.com
  2. 打开开发者工具(F12)→ Network → 任意请求 → Request Headers
  3. 复制 Cookie 字段的完整内容,填入 MCP 配置对应环境变量

Cookie 会过期,若出现 403 或数据异常,重新复制并更新配置后重启 MCP 服务即可。

安全提示: 请勿将 Cookie 写入源码或提交到 Git,仅保存在本机 MCP 配置中。

视频教程参考:

核心设计

本项目采用依赖注入设计模式:

  1. crawler 模块获取数据
  2. data_source_interface.py 定义抽象数据源接口
  3. stock_data_source.py 提供具体实现
  4. 各工具模块通过依赖注入获取数据源实例

这种设计使得:

  • ✅ 易于扩展新功能
  • ✅ 可以轻松切换不同数据源
  • ✅ 便于单元测试
  • ✅ 代码解耦,维护性强

工具模块

项目包含34个MCP工具模块,每个模块提供特定领域的功能:

  • search.py - 股票搜索和交易日信息
  • real_time_data.py - 实时股票行情数据
  • kline_data.py - K线数据和技术指标
  • fundamental.py - 基本面数据(主营构成、经营范围等)
  • valuation.py - 估值分析数据(市盈率、市净率等)
  • financial_analysis.py - 财务分析数据(财务比率、业绩概况等)
  • market.py - 市场行情数据(板块行情、资金流向等)
  • smart_review.py - 智能点评和评分

开发指南

详情请查看开发指南

注意事项

⚠️ 重要提醒:

  1. 本服务提供的数据仅供参考,不构成投资建议
  2. 仅允许个人学习、研究、使用,禁止用于商业用途。严禁滥用!
  3. 请遵守数据使用协议和相关法律法规

开源协议

MIT License

贡献

欢迎提交 Issue 和 Pull Request!

联系方式

如有问题,请提交 Issue 或联系项目开发者。
求一个star,感激不尽!

Metadata

Release files for real-time-stock-mcp-service 3.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for real-time-stock-mcp-service 3.0.1
File Size Uploaded Provenance
real_time_stock_mcp_service-3.0.1.tar.gz 57.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for real-time-stock-mcp-service 3.0.1
File Interpreter ABI Platform
real_time_stock_mcp_service-3.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 133.7 kB

Release files / real_time_stock_mcp_service-3.0.1.tar.gz

Download URL real_time_stock_mcp_service-3.0.1.tar.gz
Size 57.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6d31b5795ded150d33c35c6741d4a7dead800ed3413a86ff19c61080b8e961e8
BLAKE2b-256 checksum
How to use checksums
a07b08d05c7b960d7972ebdb8bd4c6b0ff414d84d08c96d0efa9aeed956ebb8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.17

Release files / real_time_stock_mcp_service-3.0.1-py3-none-any.whl

Download URL real_time_stock_mcp_service-3.0.1-py3-none-any.whl
Size 75.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7dd520386ff75c7148333aac1d500bcb8db9f47544f182535b9fdec08c86ca69
BLAKE2b-256 checksum
How to use checksums
cce15542035fe5274a6c08b475288744389d2a3bd73131360b1b727723ac4f63
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.17

Security for real-time-stock-mcp-service 3.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page