股海罗盘 GH-Data MCP Server

A 股全维度数据引擎 — 16 个工具覆盖财务/行情/解禁/增减持/研报/调研/持仓/分红/资金流向/两融/高管变动/K线

ghdata-mcp 是一个基于 FastMCP 协议的 A 股数据服务 Python 包，为 QwenPaw 等 MCP 客户端提供一站式股票数据分析能力。

🔑 API Key 验证（v3.0 — 服务端管理次数）

本 MCP Server 在每次工具调用前需经由服务端验证 API Key，按工具/日进行次数管理。

首次使用

• 无 Key 时自动生成 GUID 格式 Key，保存到 ~/.ghdata/ghdataapikey
• 免费版每工具每日 3 次，付费版 100 次
• 次数用完提示购买：https://www.oraskl.com/ghdata-admin

设置 Key 的方式（优先级从高到低）

# 方式 1：环境变量（推荐）
export GHDATA_API_KEY=你的Key

# 方式 2：CWD/.apikey 文件
echo -n "你的Key" > .apikey

# 方式 3：~/.ghdata/ghdataapikey（Skill 自动生成时写入）
echo -n "你的Key" > ~/.ghdata/ghdataapikey

购买付费版

👉 https://www.oraskl.com/ghdata-admin

🚀 快速安装

方式一：从 PyPI 安装（推荐）

pip install ghdata-mcp
playwright install chromium

方式二：从 GitHub 安装

pip install git+https://github.com/sunbinpy/ghdatamcp.git
playwright install chromium

方式三：本地安装

cd setup
pip install .
playwright install chromium

方式四：直接运行（无需安装）

pip install mcp[cli] matplotlib numpy playwright
playwright install chromium
python server.py

🔌 注册到 QwenPaw

方式 A：通过 pip 安装后注册（推荐）

{
  "gh-data": {
    "command": "python",
    "args": ["-m", "ghdata_mcp"],
    "env": {}
  }
}

方式 B：直接运行文件注册

{
  "gh-data": {
    "command": "python",
    "args": ["路径/server.py"],
    "env": {}
  }
}

🛠️ 工具清单

⚙️ 依赖

⚠️ 已知限制

1. 资金流向收盘价可能延迟 — 涨跌停日需用新浪/腾讯验证
2. 不支持北交所 — 工具 13、16 不支持北交所股票
3. 腾讯分钟数据是累计值 — 需差分计算

📄 免责声明

数据来源：东方财富、同花顺、新浪财经、腾讯财经等公开市场数据。

仅供学习研究，不构成投资建议。 数据可能存在延迟，使用者应自行核实。