ashare-mcp

生产级中国 A 股数据 MCP server,基于 fastmcp 3.x + akshare。一份代码同时支持 stdio 与 Streamable HTTP 两种传输,可作为常驻服务接入 Claude Desktop / Claude Code / Claude.ai / ChatGPT。

覆盖:实时行情、日/分钟 K 线、个股资料、资金流向、龙虎榜、融资融券、沪深港通、 筹码分布、财报/业绩预告快报/公告/研报、涨停池、千股千评、限售解禁,以及 ChatGPT 兼容的 search / fetch。共 30 个 tool。

• 主数据源 akshare(东方财富等);K 线/财报失败自动降级 baostock,可选 tushare。
• 失败重试(指数退避 1s/2s)→ 降级 → 结构化错误,异常绝不冒泡(不会拖垮客户端连接)。
• SQLite 缓存(分级 TTL)、loguru 日志(轮转)、股票代码与日期统一规范化。
• DataFrame 一律转 list[dict],中文列名映射为英文 snake_case(值保留原文)。

---

⚠️ 数据可靠性边界(必读)

不同数据"硬度"差别很大,用前务必理解:

任何数据与分析均不构成投资建议。

---

1. 快速开始(Mac Mini M4 / Apple Silicon, macOS 14+)

# 安装 uv(如未安装)
brew install uv

cd ashare-mcp
uv sync                     # 安装依赖(Python 3.11 由 uv 自动管理)
cp .env.example .env        # 按需填写(全部可留空)

# 本地 stdio 运行(给 Claude Desktop / Claude Code)
uv run ashare-mcp

# 远程 HTTP 运行(给 Claude.ai / ChatGPT,经 cloudflared 暴露)
uv run ashare-mcp --transport http --port 9876
# 健康检查: curl http://127.0.0.1:9876/health

可选安装:

uv sync --extra tushare     # 启用 tushare 降级(还需在 .env 配 TUSHARE_TOKEN)
uv sync --extra dev         # 安装 pytest / ruff(开发用)

实测环境:fastmcp 3.3.1、akshare 1.18.64、baostock 0.9.10、pandas 3.0.3、Python 3.11.15。

---

2. 配置(.env)

---

3. 工具清单(30)

A. 行情 get_realtime_quote · get_daily_kline · get_minute_kline · get_stock_info B. 资金流向(均带口径警告) get_individual_fund_flow · get_market_fund_flow · get_sector_fund_flow_rank · get_main_fund_flow_rank C. 龙虎榜(官方 T+1) get_lhb_daily · get_lhb_stock_detail · get_lhb_institution_daily · get_lhb_active_branches D. 融资融券(官方 T+1) get_margin_summary · get_margin_stock_detail E. 沪深港通 get_southbound_flow(可用) · get_northbound_top10_today(降级) · get_northbound_holdings(季度) · get_northbound_realtime/get_northbound_daily_net_flow(已停用,返回明确错误) F. 筹码分布(概率模型) get_chip_distribution G. 财报与公告 get_financial_report · get_earnings_forecast · get_earnings_express · get_announcements · get_research_reports