Skip to main content

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

Project description

实时股票分析 MCP 服务


这是一个实时股票数据服务的MCP(Model Context Protocol)服务器。它通过东方财富网获取金融数据,并将这些数据以工具的形式暴露给支持MCP的AI模型。

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

  • 免费免登录获取数据,免数据源token
  • 部分功能支持B股,H股

功能特性

  • 📊 查找股票
  • 📈 K线数据查询(日线、周线、月线等)
  • 📉 技术指标分析
  • 💰 基本面数据分析
  • 📊 财务分析
  • 📈 市场行情跟踪
  • 🤖 智能点评和评分
    共33个MCP工具

使用方法

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

1. 魔搭社区一键云部署

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

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

2. 本地stdio模式(以Claude Desktop为例)

在 Claude Desktop 中配置

编辑 Claude Desktop 的配置文件:

Windows: %APPDATA%\Claude\claude_desktop_config.json
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

添加以下配置:

{
  "mcpServers": {
    "stock-mcp": {
      "args": [
        "real-time-stock-mcp-service"
      ],
      "command": "uvx"
    }
  }
}

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

视频教程参考:

核心设计

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

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

这种设计使得:

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

工具模块

项目包含33个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-1.0.0.tar.gz (46.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-1.0.0-py3-none-any.whl (65.4 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for real_time_stock_mcp_service-1.0.0.tar.gz
Algorithm Hash digest
SHA256 a4de8bb948430d0fb2f621f9bbd1fc24a8e6bb3769fa0d13a70c97fbd3310c55
MD5 f3ae511a4d9d25109f8ef5c875fc10be
BLAKE2b-256 a7044f0e56059d68cfdbb611b777e8d5d7e66e04e22086386d08ab9e45fcaefa

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for real_time_stock_mcp_service-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7dbb223a9368ab40e7b63c6d4af6a2b03c73520fed552a70a7590519cf264cfc
MD5 23fd6f9a774cb890253e9558b8156b46
BLAKE2b-256 23226cab3a14a9cbe624e241908d3c230916f8a468962ede13556cdcb42cb92a

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