A 股数据 MCP 服务 (CnStock)
这是一个为大模型提供的 A 股数据 MCP (Model Context Protocol) 服务。
项目亮点
- 数据全面：覆盖沪深京全市场股票及 场内 ETF 基金。
主要改进点
- 数据源迁移：由
AkShare和efinance提供数据，无需私有 API。 - 算法对齐：优化了 KDJ 和振幅算法，数据与主流交易 APP 保持一致指标。
- 批量查询支持：核心工具支持批量查询 (单次上限 4 个)，极大提升多股分析效率。
- 智能纠偏 (Healing)：内置市场前缀自动校准功能 (e.g. SH000333 -> SZ000333)。
- 输出规格化：采用 Pydantic 定义结构化 JSON，支持 MCP Inspector 完整 Schema。
功能特性
支持 A 股和场内 ETF 行情查询，目前为大模型提供以下维度的数据：
- 基本信息：股票代码、名称、所属行业概念、总市值、流通市值等。
- 行情数据：实时价格、成交量、换手率，以及历史 K 线统计。
- 财务数据：近年的主要财务指标（净利润、营收、ROE、EPS、NAV 等）。
- 技术指标：实时计算 KDJ、MACD、RSI、布林带等常用指标。
这些数据通过以下三个 MCP 工具提供，所有工具均支持逗号分隔的批量输入（上限 4 个）：
brief: 提供股票基本信息、当日行情及 实时资金流向。medium: 在brief基础上增加主要财务数据摘要。full: 提供最完整的数据，包括详细财务报表及实时技术指标 (KDJ, MACD 等)。
批量查询指引
所有核心工具 (brief, medium, full) 均支持批量模式。
1. 调用方式
在证券代码参数中，使用 半角逗号 分隔多个代码： symbol="SZ300308,SH600000,SZ000333"
2. 返回结构
服务将返回一个结构化的 JSON 对象：
reports: 一个字典，键为证券代码，值为该标的的 Markdown 格式详细报告。errors: 一个字典，包含查询失败的代码及其原因。symbols_count: 成功生成的报告数量。
3. 智能纠偏 (Symbol Healing)
如果你输入了错误的市场前缀（例如将美的集团 SZ000333 误输入为 SH000333），系统会自动识别归属并返回 规范化后的正确代码，确保数据分析不中断。
开发与运行
1. 环境准备
建议使用 Python 3.12+ 编译环境（本说明以 Python 3.13 为例）。
# 克隆仓库
git clone git@github.com:lllyin/mcp-cn-a-stock.git
cd mcp-cn-a-stock
# 创建虚拟环境 (.venv)
python3.13 -m venv .venv
# 激活虚拟环境
source .venv/bin/activate
# 安装依赖 (推荐使用 uv)
uv sync
# 或者使用 pip
pip install .2. 配置说明
在项目根目录下创建 .env 文件，配置 AkShare Proxy Patch（用于提高东财接口稳定性）：
AKSHARE_PROXY_IP=你的代理IP
AKSHARE_PROXY_PASSWORD=你的代理密码
AKSHARE_PROXY_PORT=503. 启动服务
# 使用 uv 运行
uv run cn-stock-mcp --transport http
# 或者直接运行 python
python3 main.py --transport http服务默认运行在 http://localhost:8686/cnstock/mcp。
4. 调试与测试
使用 MCP Inspector 进行交互式调试：
npx @modelcontextprotocol/inspector --url http://localhost:8686/cnstock/mcp客户端接入
你可以将此服务接入常用的 MCP 客户端（如 Claude Desktop, CherryStudio, DeepChat 等）。
CherryStudio 配置示例
- 进入 设置 -> MCP 设置 -> 添加服务器。
- 类型选择
可流式传输的HTTP(streamableHttp)，地址填入http://localhost:8686/cnstock/mcp。
免责申明
本项目利用开源社区接口尽可能的保障数据准确可用, 但不对因数据延迟或错误产生的任何交易决策负任何责任。股市有风险，入市需谨慎。
许可证
基于原项目协议，本项目采用 MIT 许可证。
联系方式
如有问题或建议，欢迎提交 Issue。