MCP 服务器

HTZL A Share MCP

MCP server providing 29 A-share analysis skills including real-time data, capital flow, limit-up tracking, technical/fundamental analysis, backtesting, risk control, and Xueqiu portfolio tracking, enabling AI agents to execute market research and strategy tasks.

README

HTZL A Share MCP

🔥 慧途智联 A 股 MCP 服务 —— 29 个即插即用 Skills 覆盖数据采集/大盘分析/资金流向/涨停追踪/技术面/基本面/估值/财报/多因子/回测/风控/智能报告/自选股监控/雪球调仓。Claude Code / CoWork / OpenClaw / Cherry Studio 首选搭档。

A-Share MCP for AI Agents — 5400+ A 股上市公司 · akshare + tushare + 东财双源 · Apache-2.0

🎯 为什么需要 HTZL A Share MCP？

让 Claude / GPT / Gemini 等 AI Agent 直接调用 A 股数据分析和策略工具：

✅ 29 个即插即用 Skills —— 一行 pip install 启用全部能力
✅ 多源故障转移 —— akshare → tushare → mock 三层兜底
✅ 雪球集成 —— pysnowball 1,825⭐ Apache-2.0 底层
✅ Claude Code 友好 —— stdio 模式即插即用
✅ 生产就绪 —— pytest 104/104 ✅ + Dockerfile + PyPI + GitHub Actions CI

🚀 快速开始

1. 安装

pip install htzl-a-share-mcp

2. 启动 MCP Server

stdio 模式（推荐用于 Claude Code）：

python -m htzl_a_share_mcp.server --transport stdio

HTTP 模式（推荐用于 CoWork / Cherry Studio）：

python -m htzl_a_share_mcp.server --transport streamable-http --host 0.0.0.0 --port 8000

3. 在 Claude Code 中使用

// ~/.claude/mcp_servers.json
{
  "mcpServers": {
    "htzl-a-share": {
      "command": "python",
      "args": ["-m", "htzl_a_share_mcp.server", "--transport", "stdio"]
    }
  }
}

然后在 Claude Code 对话中：

帮我分析贵州茅台（600519）的当前估值和最近一周的资金流向

📊 29 Skills 全景

数据层 (5)

get_stock_daily - A 股日线数据（多源故障转移）
get_stock_realtime - A 股实时行情
get_stock_basic - 股票基本信息（PE/PB/市值）
get_etf_list - ETF 列表
get_index_daily - 指数日线（沪深300/创业板等）

资金流向 (2)

get_capital_flow - 个股资金流向（主力/散户）
get_sector_flow - 板块资金流向

涨停追踪 (2)

get_limit_up_pool - 涨停股池
get_limit_up_stats - 涨停统计（连板率/炸板率）

技术面 (3)

turtle_signal - 海龟交易法信号
macd_signal - MACD 信号
kdj_signal - KDJ 随机指标

估值 (2)

get_pe - PE 估值
get_pb - PB 估值

财报 (2)

get_income_statement - 利润表
get_financial_indicators - 财务指标

多因子 (1)

multi_factor_select - 多因子选股

回测 (3)

backtest_turtle - 海龟交易法回测
backtest_multi_factor - 多因子回测
backtest_compare - 策略对比回测

风控 (2)

risk_var - VaR 风险价值
risk_position_size - Kelly 公式头寸

智能报告 (3)

generate_daily_report - 个股日报
generate_sector_report - 板块周报
generate_portfolio_report - 组合持仓报告

自选股监控 (2)

add_to_watchlist - 加入自选股
get_watchlist_alerts - 自选股预警

雪球调仓 (2)

get_xueqiu_quote - 雪球实时行情
track_xueqiu_portfolio - 雪球组合调仓追踪

🏗️ 架构

┌─────────────────────────────────────────────────────────┐
│  Claude Code / CoWork / OpenClaw / Cherry Studio        │
│  (MCP Client via stdio or HTTP)                          │
└────────────────────┬────────────────────────────────────┘
                     │ MCP Protocol
┌────────────────────▼────────────────────────────────────┐
│  HTZL A Share MCP Server (FastMCP 3.4)                  │
│  29 Skills (data + strategies + community + push)        │
└────┬─────────┬─────────┬─────────────┬──────────────────┘
     │         │         │             │
┌────▼───┐ ┌──▼────┐ ┌──▼────────┐ ┌──▼─────────┐
│ Data   │ │Strategy│ │Community │ │Push       │
│ Sources│ │ Layer  │ │ Layer    │ │ Layer     │
│ akshare│ │ turtle │ │ xueqiu   │ │ feishu    │
│ tushare│ │ chanlun│ │ tracker  │ │ alert     │
│ mock   │ │ factor │ │          │ │           │
└────────┘ └────────┘ └──────────┘ └───────────┘

🐳 Docker 部署

docker build -t htzl-a-share-mcp .
docker-compose up -d

环境变量：

HTZL_USE_MOCK - 是否使用 mock 数据（默认 true）
TUSHARE_TOKEN - Tushare Pro token
XUEQIU_TOKEN - 雪球 token
FEISHU_WEBHOOK - 飞书 webhook URL

🔧 开发

git clone https://github.com/mm2xai/htzl-a-share-mcp-demo.git
cd htzl-a-share-mcp-demo

# 创建虚拟环境
python3.12 -m venv .venv
source .venv/bin/activate

# 清华源加速
pip install -e ".[dev]" -i https://pypi.tuna.tsinghua.edu.cn/simple/

# 测试
pytest tests/ -v