real-time-stock-mcp-service 1.1.2__tar.gz

real_time_stock_mcp_service-1.1.2/.gitignore

@@ -0,0 +1,54 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+ENV/
+env/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Environment variables
+.env
+
+# Logs
+*.log
+logs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# uv
+.uv/
+
+# MCP
+.mcp/
+/.lingma/

real_time_stock_mcp_service-1.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Danny Wong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

real_time_stock_mcp_service-1.1.2/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: real-time-stock-mcp-service
+Version: 1.1.2
+Summary: 一个获取实时股票数据服务和分析的MCP服务器
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: mcp>=1.1.2
+Requires-Dist: pandas>=2.2.0
+Requires-Dist: python-dateutil>=2.9.0
+Requires-Dist: requests>=2.32.0
+Description-Content-Type: text/markdown
+
+# 实时股票分析 MCP 服务
+
+---
+
+这是一个实时股票数据服务的MCP服务器。它通过东方财富网获取金融数据，并将这些数据以工具的形式暴露给支持MCP的AI模型。
+
+> **代码仓库：** https://github.com/DannyWongIsAvailable/real-time-stock-mcp-service.git
+
+- 免费免登录获取数据，免token
+- 部分功能支持B股，H股
+
+## 功能特性
+
+- 📊 查找股票
+- 📈 K线数据查询（支持B股，H股，大盘）
+- 📉 技术指标分析 （MA，MACD，BOLL，KDJ等等）
+- 💰 基本面数据分析（主营构成、经营范围等）
+- 📊 财务分析（财务比率、业绩概况等）
+- 💰 估值分析数据（市盈率、市净率等）
+- 📈 市场行情跟踪（板块行情、同行对比、资金流向等）
+- 🤖 智能点评和评分  
+
+共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`  
+
+添加以下配置：
+
+```json
+{
+  "mcpServers": {
+    "stock-mcp": {
+      "args": [
+        "real-time-stock-mcp-service"
+      ],
+      "command": "uvx"
+    }
+  }
+}
+```
+
+> **注意：** 将路径替换为你的实际项目路径。
+
+
+#### 视频教程参考：
+- [火遍全网的MCP是什么？怎么用？如何自己开发一个MCP服务？一个视频带你入门！](https://www.bilibili.com/video/BV13R5EzbE6E/?spm_id_from=333.337.search-card.all.click&vd_source=08fc400fe0cfc7eaa723687b764b29f3)
+- [Cherry Studio MCP 使用入门教程：从配置到使用](https://www.bilibili.com/video/BV1bkdAYTEYp/?spm_id_from=333.337.search-card.all.click&vd_source=08fc400fe0cfc7eaa723687b764b29f3)
+
+## 核心设计
+
+本项目采用**依赖注入**设计模式：
+
+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` - 智能点评和评分
+
+
+## 开发指南
+
+详情请查看[开发指南](DEVELOPMENT.md)  
+
+## 注意事项
+
+⚠️ **重要提醒**：
+1. 本服务提供的数据仅供参考，不构成投资建议
+2. 仅允许个人学习、研究、使用，禁止用于商业用途。严禁滥用！
+3. 请遵守数据使用协议和相关法律法规
+
+## 开源协议
+
+[MIT License](LICENSE)
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 联系方式
+
+如有问题，请提交 Issue 或联系项目开发者。  
+求一个star，感激不尽！

real_time_stock_mcp_service-1.1.2/README.md

@@ -0,0 +1,117 @@
+# 实时股票分析 MCP 服务
+
+---
+
+这是一个实时股票数据服务的MCP服务器。它通过东方财富网获取金融数据，并将这些数据以工具的形式暴露给支持MCP的AI模型。
+
+> **代码仓库：** https://github.com/DannyWongIsAvailable/real-time-stock-mcp-service.git
+
+- 免费免登录获取数据，免token
+- 部分功能支持B股，H股
+
+## 功能特性
+
+- 📊 查找股票
+- 📈 K线数据查询（支持B股，H股，大盘）
+- 📉 技术指标分析 （MA，MACD，BOLL，KDJ等等）
+- 💰 基本面数据分析（主营构成、经营范围等）
+- 📊 财务分析（财务比率、业绩概况等）
+- 💰 估值分析数据（市盈率、市净率等）
+- 📈 市场行情跟踪（板块行情、同行对比、资金流向等）
+- 🤖 智能点评和评分  
+
+共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`  
+
+添加以下配置：
+
+```json
+{
+  "mcpServers": {
+    "stock-mcp": {
+      "args": [
+        "real-time-stock-mcp-service"
+      ],
+      "command": "uvx"
+    }
+  }
+}
+```
+
+> **注意：** 将路径替换为你的实际项目路径。
+
+
+#### 视频教程参考：
+- [火遍全网的MCP是什么？怎么用？如何自己开发一个MCP服务？一个视频带你入门！](https://www.bilibili.com/video/BV13R5EzbE6E/?spm_id_from=333.337.search-card.all.click&vd_source=08fc400fe0cfc7eaa723687b764b29f3)
+- [Cherry Studio MCP 使用入门教程：从配置到使用](https://www.bilibili.com/video/BV1bkdAYTEYp/?spm_id_from=333.337.search-card.all.click&vd_source=08fc400fe0cfc7eaa723687b764b29f3)
+
+## 核心设计
+
+本项目采用**依赖注入**设计模式：
+
+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` - 智能点评和评分
+
+
+## 开发指南
+
+详情请查看[开发指南](DEVELOPMENT.md)  
+
+## 注意事项
+
+⚠️ **重要提醒**：
+1. 本服务提供的数据仅供参考，不构成投资建议
+2. 仅允许个人学习、研究、使用，禁止用于商业用途。严禁滥用！
+3. 请遵守数据使用协议和相关法律法规
+
+## 开源协议
+
+[MIT License](LICENSE)
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 联系方式
+
+如有问题，请提交 Issue 或联系项目开发者。  
+求一个star，感激不尽！

real_time_stock_mcp_service-1.1.2/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "real-time-stock-mcp-service"
+version = "1.1.2"
+description = "一个获取实时股票数据服务和分析的MCP服务器"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+  "mcp>=1.1.2",
+  "requests>=2.32.0",
+  "pandas>=2.2.0",
+  "python-dateutil>=2.9.0",
+]
+
+# 给托管/本地一个稳定的命令入口：执行 stock-mcp 就能跑
+[project.scripts]
+real-time-stock-mcp-service = "stock_mcp.app:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+# 告诉 hatchling 包在 src/ 下，且包名是 stock_mcp
+[tool.hatch.build.targets.wheel]
+packages = ["src/stock_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/stock_mcp/**", "README.md", "pyproject.toml"]

real_time_stock_mcp_service-1.1.2/src/stock_mcp/__main__.py

@@ -0,0 +1,8 @@
+"""
+让托管平台可以用 `python -m stock_mcp` 一条命令拉起服务
+"""
+
+from stock_mcp.app import main
+
+if __name__ == "__main__":
+    main()

real_time_stock_mcp_service-1.1.2/src/stock_mcp/app.py

@@ -0,0 +1,113 @@
+"""
+股票数据 MCP Server（托管友好入口）
+"""
+
+import logging
+import os
+from datetime import datetime
+
+from mcp.server.fastmcp import FastMCP
+
+from stock_mcp.data_source_interface import FinancialDataInterface
+from stock_mcp.stock_data_source import WebCrawlerDataSource
+from stock_mcp.utils.utils import setup_logging
+
+from stock_mcp.mcp_tools.search import register_search_tools
+from stock_mcp.mcp_tools.kline_data import register_kline_tools
+from stock_mcp.mcp_tools.real_time_data import register_real_time_data_tools
+from stock_mcp.mcp_tools.fundamental import register_fundamental_tools
+from stock_mcp.mcp_tools.valuation import register_valuation_tools
+from stock_mcp.mcp_tools.financial_analysis import register_financial_analysis_tools
+from stock_mcp.mcp_tools.market import register_market_tools
+from stock_mcp.mcp_tools.smart_review import register_smart_review_tools
+
+
+def build_app(active_data_source: FinancialDataInterface) -> FastMCP:
+    """
+    构建 FastMCP app（只做“创建 + 注册工具”）
+    """
+    current_date = datetime.now().strftime("%Y-%m-%d")
+
+    app = FastMCP(
+        name="real-time-stock-mcp-service",
+        instructions=f"""📊 一个获取实时股票数据服务和分析的MCP服务器
+
+**今天日期**: {current_date}
+
+📈 主要功能:
+- 查找股票名称，代码
+- 实时股票数据
+- K线数据（日线、周线、月线）
+- 计算技术指标
+- 基本面数据（主营构成、经营范围、经营评述等）
+- 估值分析数据（市盈率、市净率等）
+- 板块行情数据
+- 智能点评和评分
+""",
+    )
+
+    # ✅ 注册所有工具
+    register_search_tools(app, active_data_source)
+    register_real_time_data_tools(app, active_data_source)
+    register_kline_tools(app, active_data_source)
+    register_fundamental_tools(app, active_data_source)
+    register_valuation_tools(app, active_data_source)
+    register_financial_analysis_tools(app, active_data_source)
+    register_market_tools(app, active_data_source)
+    register_smart_review_tools(app, active_data_source)
+
+    return app
+
+
+def main() -> None:
+    """
+    程序主入口：
+    1) 配日志
+    2) 创建数据源（依赖注入）
+    3) 构建 app + 注册工具
+    4) 初始化数据源
+    5) app.run() 启动（stdio）
+    6) finally 清理资源
+    """
+    # ✅ 托管环境常用环境变量控制日志级别，方便排障
+    log_level = os.getenv("LOG_LEVEL", "INFO").upper()
+    setup_logging(level=getattr(logging, log_level, logging.INFO))
+    logger = logging.getLogger(__name__)
+
+    # 1) 依赖注入：后续切换数据源只改这里
+    active_data_source: FinancialDataInterface = WebCrawlerDataSource()
+    logger.info("数据源: %s", active_data_source.__class__.__name__)
+
+    # 2) 构建 app（注册工具）
+    app = build_app(active_data_source)
+    logger.info("工具模块注册完成")
+
+    # 3) 初始化数据源
+    try:
+        if active_data_source.initialize():
+            logger.info("✅ 数据源初始化成功")
+        else:
+            logger.warning("⚠️ 数据源初始化失败，某些功能可能不可用")
+    except Exception:
+        logger.exception("💥 数据源初始化异常：将继续启动（功能可能受限）")
+
+    # 4) 运行服务（托管通常走 stdio，保持默认）
+    try:
+        logger.info("🚀 启动 MCP Server（stdio）")
+        app.run()
+    except KeyboardInterrupt:
+        logger.info("🛑 服务被中断")
+    except Exception:
+        logger.exception("💥 服务运行出错")
+        raise
+    finally:
+        # 5) 清理资源
+        try:
+            active_data_source.cleanup()
+            logger.info("🧹 资源清理完成")
+        except Exception:
+            logger.exception("💥 资源清理异常")
+
+
+if __name__ == "__main__":
+    main()

real_time_stock_mcp_service-1.1.2/src/stock_mcp/crawler/base_crawler.py

@@ -0,0 +1,153 @@
+import re
+import time
+import json
+import random
+import requests
+from abc import ABC
+from typing import Optional, Dict, Any
+
+
+class EastMoneyBaseSpider(ABC):
+    """
+    东方财富爬虫基类
+
+    提供通用功能：
+    - Session 管理
+    - 请求头/Cookies 配置
+    - JSONP 解析
+    - 股票代码格式转换
+    """
+
+    # 子类可覆盖的默认配置
+    DEFAULT_TIMEOUT = 10
+    DEFAULT_HEADERS = {
+        "Accept": "application/json, text/plain, */*",
+        "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+        "Connection": "keep-alive",
+        "User-Agent": (
+            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
+            "AppleWebKit/537.36 (KHTML, like Gecko) "
+            "Chrome/129.0.0.0 Safari/537.36"
+        ),
+    }
+
+    def __init__(
+            self,
+            session: Optional[requests.Session] = None,
+            timeout: int = None,
+    ):
+        self.session = session or requests.Session()
+        self.timeout = timeout or self.DEFAULT_TIMEOUT
+        self.headers = self.DEFAULT_HEADERS.copy()
+        self.cookies: Dict[str, str] = {}
+
+    # ==================== 通用工具方法 ====================
+
+    def _get(
+            self,
+            url: str,
+            params: Dict[str, Any] = None,
+            **kwargs
+    ) -> requests.Response:
+        """封装 GET 请求"""
+        return self.session.get(
+            url,
+            params=params,
+            headers=self.headers,
+            cookies=self.cookies,
+            timeout=self.timeout,
+            **kwargs
+        )
+
+    def _get_json(self, url: str, params: Dict[str, Any] = None) -> Dict:
+        """GET 请求并解析 JSON"""
+        resp = self._get(url, params)
+        resp.raise_for_status()
+        return resp.json()
+
+    def _get_jsonp(self, url: str, params: Dict[str, Any] = None) -> Optional[Dict]:
+        """GET 请求并解析 JSONP"""
+        resp = self._get(url, params)
+        resp.raise_for_status()
+        return self._parse_jsonp(resp.text)
+
+    @staticmethod
+    def _parse_jsonp(text: str) -> Optional[Dict]:
+        # 允许末尾有分号
+        match = re.search(r'^\w+\((.*)\);?$', text.strip(), re.DOTALL)
+        if not match:
+            return None
+        try:
+            return json.loads(match.group(1))
+        except json.JSONDecodeError:
+            return None
+
+    @staticmethod
+    def _generate_callback() -> str:
+        """生成 jQuery 风格的 JSONP callback 名称"""
+        rand_part = random.randint(10 ** 19, 10 ** 20 - 1)
+        ts = int(time.time() * 1000)
+        return f"jQuery{rand_part}_{ts}"
+
+    @staticmethod
+    def _timestamp_ms() -> int:
+        """当前时间戳（毫秒）"""
+        return int(time.time() * 1000)
+
+    @staticmethod
+    def format_secid(stock_code: str) -> str:
+        """
+        将股票代码转换为东方财富的 secid 格式
+
+        支持格式：
+        - "000977"      -> "0.000977" (深市)
+        - "600000"      -> "1.600000" (沪市)
+        - "000977.SZ"   -> "0.000977"
+        - "600000.SH"   -> "1.600000"
+        - "0.000977"    -> "0.000977" (已是 secid)
+        - "00977.HK"    -> "116.00977" (H股)
+        - "116.00977"   -> "116.00977" (已是 secid)
+        - "01810"       -> "116.01810" (港股)
+        - "01810.HK"    -> "116.01810" (港股)
+
+        :param stock_code: 股票代码
+        :return: secid 格式字符串
+        """
+        code = stock_code.strip().upper()
+
+        if "." in code:
+            left, right = code.split(".", maxsplit=1)
+
+            # 已经是 secid 格式
+            if left in {"0", "1", "116"} and right.isdigit():
+                return f"{left}.{right}"
+
+            # 带后缀格式：000977.SZ
+            if right in {"SZ", "SH"}:
+                market = "0" if right == "SZ" else "1"
+                return f"{market}.{left}"
+            
+            # H股格式：00977.HK 或 01810.HK
+            if right == "HK":
+                return f"116.{left.zfill(5)}"  # 港股代码补齐为5位
+
+        # 纯数字代码
+        if code.isdigit():
+            # 6 开头沪市，其他深市
+            if code.startswith("6"):
+                return f"1.{code}"
+            # 5位数港股代码（通常以0开头）
+            elif len(code) == 5:
+                return f"116.{code}"
+            # 其他情况为深市
+            else:
+                return f"0.{code}"
+
+        raise ValueError(f"无法解析股票代码: {stock_code}")
+
+
+
+
+
+
+