@youhaozhao/cninfo-mcp 1.3.0 → 1.4.1

package/README.md

@@ -4,6 +4,9 @@
 
 通过 MCP 协议查询和下载巨潮资讯网上市公司定期报告及招股书 PDF 的工具，适用于 Claude Desktop / Claude Code。
 
+## 并发限制
+巨潮资讯网后端禁止大量并发，推荐将并发数设置为 4 以防止后端返回大量 403 导致 IP 短暂被封
+
 ## 使用方法
 
 在 Claude Desktop / Claude Code 配置文件中添加：
@@ -53,7 +56,7 @@
 ## 系统要求
 
 - Node.js 18+
-- Python 3.10+（Python 依赖会自动安装）
+- Python 3.10+（Python 依赖会自动安装；需要 MCP Python SDK v2，旧环境会在下次启动时自动升级）
 
 ## 数据来源
 

package/bin/cninfo-mcp.js

@@ -73,6 +73,9 @@ async function ensureVenv(systemPythonCmd) {
   return venvPython;
 }
 
+// 依赖探针：校验 venv 是否满足 requirements.txt 的全部约束
+const DEPS_CHECK = path.join(__dirname, "..", "python", "check_deps.py");
+
 // 检查并安装 Python 依赖（使用 venv 中的 python）
 async function ensureDependencies(venvPython) {
   const requirementsPath = PYTHON_REQUIREMENTS;
@@ -83,8 +86,8 @@ async function ensureDependencies(venvPython) {
   }
 
   try {
-    // 检查 mcp 包是否已安装
-    await spawnAsync(venvPython, ["-c", "import mcp"]);
+    // 校验依赖是否满足约束（不满足时抛错，转入下方安装流程）
+    await spawnAsync(venvPython, [DEPS_CHECK]);
   } catch (error) {
     // 未安装，执行安装
     console.error("Installing Python dependencies...");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youhaozhao/cninfo-mcp",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "MCP Server for querying and downloading Chinese listed companies' periodic reports from CNINFO (巨潮资讯网)",
   "keywords": [
     "mcp",
@@ -59,6 +59,7 @@
   "files": [
     "bin/",
     "python/mcp_server.py",
+    "python/check_deps.py",
     "python/spider.py",
     "python/requirements.txt",
     "scripts/install-python-deps.js",

package/python/check_deps.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+"""校验当前解释器是否满足 requirements.txt 的全部约束。
+
+退出码 0 表示全部满足,调用方可以跳过 pip 安装;非 0 表示需要执行
+`pip install -r requirements.txt`。
+
+这个脚本只是一个优化——用来省掉一次很慢的 pip 调用,pip 自身才是约束的
+最终权威。因此所有无法确定的情况(依赖缺失、版本不符、约束解析失败、
+连比较版本号的库都找不到)一律返回非 0,让 pip 去做真正的判断。宁可多跑
+一次 pip,也不能放行一个不满足约束的环境。
+"""
+
+import os
+import sys
+from importlib.metadata import PackageNotFoundError, version
+
+REQUIREMENTS = os.path.join(os.path.dirname(os.path.abspath(__file__)), "requirements.txt")
+
+
+def _load_requirement_parser():
+    """返回 packaging 的 Requirement 类,找不到时返回 None。
+
+    packaging 不是本项目的直接依赖,全新 venv 里通常不存在,因此回退到 pip
+    自带的 vendored 副本。部分发行版(如 Debian)会去除 vendoring,那时两者
+    都不可用,由调用方按“未满足”处理。
+    """
+    try:
+        from packaging.requirements import Requirement
+
+        return Requirement
+    except ImportError:
+        pass
+    try:
+        from pip._vendor.packaging.requirements import Requirement
+
+        return Requirement
+    except ImportError:
+        return None
+
+
+def unsatisfied(requirements_path=None):
+    """返回未满足的约束列表;无法判断时抛出异常由调用方兜底。"""
+    # 默认值在调用时解析,而不是在 def 时绑定,便于测试替换 REQUIREMENTS
+    if requirements_path is None:
+        requirements_path = REQUIREMENTS
+
+    Requirement = _load_requirement_parser()
+    if Requirement is None:
+        raise RuntimeError("packaging is unavailable; cannot verify requirements")
+
+    missing = []
+    with open(requirements_path, encoding="utf-8") as fh:
+        for raw in fh:
+            line = raw.split("#", 1)[0].strip()
+            # 跳过空行,以及 -r/-e/--index-url 这类非约束指令
+            if not line or line.startswith("-"):
+                continue
+
+            req = Requirement(line)
+            try:
+                installed = version(req.name)
+            except PackageNotFoundError:
+                missing.append(f"{req.name} (not installed)")
+                continue
+
+            # prereleases=True:已装的预发布版本若落在区间内也算满足,
+            # 避免把 pip 已经接受的环境反复重装。
+            if not req.specifier.contains(installed, prereleases=True):
+                missing.append(f"{req.name} {installed} does not satisfy {req.specifier}")
+
+    return missing
+
+
+def main():
+    try:
+        missing = unsatisfied()
+    except Exception as exc:  # 解析失败、文件缺失等一律按“需要安装”处理
+        print(f"dependency check inconclusive: {exc}", file=sys.stderr)
+        return 1
+
+    if missing:
+        for item in missing:
+            print(f"dependency not satisfied: {item}", file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/python/mcp_server.py

@@ -4,6 +4,7 @@
 用于查询和下载 A 股定期报告、招股书的 MCP 工具服务
 """
 
+import json
 import os
 import sys
 from typing import Optional
@@ -11,39 +12,39 @@ from typing import Optional
 # 将当前目录加入模块搜索路径
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 
-from mcp.server import FastMCP
+from mcp.server.mcpserver import MCPServer
 from spider import (
     query_reports,
     download_reports,
+    format_reports,
     saving_path,
     supported_report_types,
 )
 
+def _package_version(default: str = "0.0.0") -> str:
+    """从 package.json 读取版本，避免与 npm 包版本各写一份而漂移。
+
+    package.json 始终随 npm 包发布（不受 files 白名单影响），因此在已安装的
+    包里也能读到。读取失败时退回 default，不让版本号问题挡住服务器启动。
+    """
+    manifest = os.path.join(
+        os.path.dirname(os.path.abspath(__file__)), "..", "package.json"
+    )
+    try:
+        with open(manifest, encoding="utf-8") as fh:
+            return json.load(fh).get("version") or default
+    except (OSError, ValueError):
+        return default
+
+
 # 创建 MCP 服务器实例
-mcp = FastMCP(
+mcp = MCPServer(
     name="cninfo-server",
     instructions="CNINFO reports server - Query and download Chinese listed companies' periodic reports from cninfo.com.cn",
+    version=_package_version(),
 )
 
 
-def _format_reports(reports: list) -> list:
-    """提取 MCP 返回中稳定、有用的公告字段。"""
-    base_url = "https://static.cninfo.com.cn/"
-    report_details = []
-    for report in reports:
-        adj = report.get("adjunctUrl", "")
-        report_details.append(
-            {
-                "announcementTitle": report.get("announcementTitle", ""),
-                "announcementTime": report.get("announcementTime", ""),
-                "secCode": report.get("secCode", ""),
-                "secName": report.get("secName", ""),
-                "adjunctUrl": base_url + adj if adj else "",
-            }
-        )
-    return report_details
-
-
 def _supported_report_types_text() -> str:
     return ", ".join(supported_report_types().keys())
 
@@ -90,7 +91,7 @@ def query_annual_reports_tool(
             "report_type": report_type,
             "year": year,
             "count": len(reports),
-            "reports": _format_reports(reports),
+            "reports": format_reports(reports),
             "message": f"Found {len(reports)} {report_type} report(s)"
             + (f" for year {year}" if year else ""),
         }

package/python/requirements.txt

@@ -1,5 +1,5 @@
 # MCP Server dependencies
-mcp>=1.0.0
+mcp~=2.1.1
 
 # Existing dependencies
 requests>=2.31.0

package/python/spider.py

@@ -167,6 +167,27 @@ def normalize_report_type(report_type: Optional[str]) -> str:
     return normalized
 
 
+def format_reports(reports: list) -> list:
+    """提取公告中稳定、有用的字段，并把附件路径补全为可访问的绝对 URL。
+
+    放在 spider.py 是为了紧邻 download_path 前缀定义，避免调用方各自
+    硬编码一份基址。
+    """
+    formatted = []
+    for report in reports:
+        adj = report.get("adjunctUrl", "")
+        formatted.append(
+            {
+                "announcementTitle": report.get("announcementTitle", ""),
+                "announcementTime": report.get("announcementTime", ""),
+                "secCode": report.get("secCode", ""),
+                "secName": report.get("secName", ""),
+                "adjunctUrl": download_path + adj if adj else "",
+            }
+        )
+    return formatted
+
+
 def _build_headers() -> dict:
     """构造请求头，避免在并发场景下修改全局字典。"""
     headers = BASE_HEADERS.copy()

package/scripts/install-python-deps.js

@@ -18,6 +18,9 @@ const REQUIREMENTS_FILE = path.join(
 
 const VENV_DIR = path.join(os.homedir(), ".cninfo-mcp", "venv");
 
+// 依赖探针：校验 venv 是否满足 requirements.txt 的全部约束
+const DEPS_CHECK = path.join(__dirname, "..", "python", "check_deps.py");
+
 function getVenvPython() {
   if (process.platform === "win32") {
     return path.join(VENV_DIR, "Scripts", "python.exe");
@@ -101,8 +104,8 @@ async function main() {
   }
 
   try {
-    // 检查 mcp 是否已安装（用 venv 的 python）
-    await spawnCommand(venvPython, ["-c", "import mcp"]);
+    // 校验依赖是否满足约束（用 venv 的 python）
+    await spawnCommand(venvPython, [DEPS_CHECK]);
     console.log("✅ Python dependencies already installed");
   } catch (error) {
     // 执行安装（用 venv 的 pip）