Skip to main content

一个获取实时股票数据服务和分析的MCP服务器

Project description

实时股票分析 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": {
      "args": [
        "real-time-stock-mcp-service"
      ],
      "command": "uvx"
    }
  }
}

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

{
  "mcpServers": {
    "stock-mcp": {
      "command": "path/to/python.exe",
      "args": ["-m", "stock_mcp"],
      "cwd": "path/to/real-time-stock-mcp-service"
    }
  }
}

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

视频教程参考:

核心设计

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

  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,感激不尽!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

real_time_stock_mcp_service-2.0.0.tar.gz (52.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

real_time_stock_mcp_service-2.0.0-py3-none-any.whl (70.9 kB view details)

Uploaded Python 3

File details

Details for the file real_time_stock_mcp_service-2.0.0.tar.gz.

File metadata

File hashes

Hashes for real_time_stock_mcp_service-2.0.0.tar.gz
Algorithm Hash digest
SHA256 bd7edc0d07c235630e0b8774ead5f121e0ca4f5b442db1eaef0795af340cb946
MD5 16231e4d1edc00c9d14826493a2991aa
BLAKE2b-256 5caa38f08c8bcca1182de226f2991c2b53fa4dfb96a1f868283e34ef25044e1c

See more details on using hashes here.

File details

Details for the file real_time_stock_mcp_service-2.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for real_time_stock_mcp_service-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a3fb233f870fc0072deeb0a33dfc299ae8586aad5d3ca2b9ccb4aeb2eda54ed1
MD5 1d122f30e745cf6ecac1232e966b75a8
BLAKE2b-256 17854d8680d9bd93889f8ea07e74c3b272c2acc11ce2a81247fd75806c2cc334

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page