适合谁
- 需要程序化查询 A 股行情与财务数据的开发者
- 在 AI 助手中做 A 股相关问答或数据分析研究的用户
- 希望免费、无需申请付费账号即可获取 A 股数据的个人使用场景
A
64FMRS · C
该服务器功能覆盖面广（41个工具），聚焦中国 A 股的行情、财务与宏观数据查询，安装配置需手动填写绝对路径且以 Windows 环境为主要开发和验证平台，适合个人开发者和研究场景，但缺乏身份验证且依赖免费第三方数据源，不适合对数据时效性和可靠性要求较高的生产环境。
a-share-mcp 是一个面向中国 A 股市场的 MCP 服务器，基于免费的 Baostock 数据源，通过 41 个工具提供股票基础信息、历史 K 线、复权因子、分红配送、六大类财务指标（盈利、营运、成长、偿债、现金流、杜邦分析）、业绩快报与预告、指数成分股（上证50、沪深300、中证500）、行业分类、宏观经济数据（存贷款利率、存款准备金率、货币供应量）以及交易日历/日期计算等工具，理论上可以回答关于 A 股大盘或个股的绝大多数数据类问题。项目以 Python 编写，使用 uv 管理依赖，通过 stdio 传输与 MCP 客户端通信。
工具能力
get_historical_k_data
get_stock_basic_info
get_dividend_data
get_adjust_factor_data
get_profit_data
get_operation_data
get_growth_data
get_balance_data
get_cash_flow_data
get_dupont_data
get_performance_express_report
get_forecast_report
get_fina_indicator
get_trade_dates
get_all_stock
search_stocks
get_suspensions
get_stock_industry
get_index_constituents
get_sz50_stocks
get_hs300_stocks
get_zz500_stocks
list_industries
get_industry_members
get_deposit_rate_data
get_loan_rate_data
get_required_reserve_ratio_data
get_money_supply_data_month
get_money_supply_data_year
get_latest_trading_date
get_market_analysis_timeframe
is_trading_day
previous_trading_day
next_trading_day
get_last_n_trading_days
get_recent_trading_range
get_month_end_trading_dates
get_stock_analysis
normalize_stock_code
normalize_index_code
list_tool_constants
安装接入
1) 确认本机已安装 Python 3.10+ 及 uv 包管理器；2) 克隆仓库后在项目根目录执行 uv venv 创建虚拟环境；3) 激活虚拟环境（Windows: .venv\Scripts\activate；macOS/Linux: source .venv/bin/activate）；4) 执行 uv sync 安装依赖；5) 在支持 MCP 的客户端（如 Cursor、VS Code、Trae、CherryStudio）中添加一个 stdio 类型的 MCP 服务器条目，command 填 uv（或其绝对路径），args 依次为 --directory、项目根目录的绝对路径、run、python、mcp_server.py；6) 若客户端报 ModuleNotFoundError，可额外将 workingDirectory 设为项目根目录的绝对路径。
claude_desktop_config.json
{"mcpServers":{"a-share-mcp":{"command":"uv","args":["--directory","/path/to/a_share_mcp","run","python","mcp_server.py"],"transport":"stdio"}}}
选型与风险
不适合谁
- 需要实时（分钟级）盘口或逐笔行情的高频交易场景
- 需要港股、美股等非 A 股市场数据的用户
- 对数据准确性/时效性有严格合规要求的机构级生产环境（数据源为免费的 Baostock，非官方保证）
所需权限
- 运行 Python 进程并通过 uv 执行本地脚本
- 对外网络访问，用于从 Baostock 拉取行情与财务数据
- 无需配置任何 API 密钥或账号
风险与副作用
- 数据来自第三方免费数据源 Baostock，非官方维护，数据更新存在延迟（如当日K线需17:30后才入库）
- 项目主要在 Windows 环境下开发和测试，跨平台（macOS/Linux）兼容性未充分验证
- 无身份验证机制，任何能访问该 MCP 服务的客户端均可调用全部工具及查询数据
- 若 Baostock 接口发生变更，可能导致部分工具失效且无官方支持保障
常见排障
- 出现 ModuleNotFoundError 时，检查是否已执行 `uv sync` 安装依赖，并尝试在客户端配置中显式设置 workingDirectory 为项目根目录
- 确认 `command` 中的 uv 路径客户端可执行访问，必要时改用 uv.exe 的绝对路径
- Windows 路径需使用双反斜杠转义（如 `C:\\Users\\...`），macOS/Linux 使用正斜杠且无需转义
- 查询当日数据无返回或数据缺失时，注意 Baostock 官方数据入库时间点（如日K线17:30后、分钟K线次日11:00后）
- CherryStudio 中配置后开关无反应，可尝试切换到其他菜单再返回 MCP 设置页面刷新状态
使用场景
查询个股历史K线、复权因子与分红配送数据
获取上市公司盈利能力、成长能力、偿债能力等财务指标
查看上证50、沪深300、中证500等指数成分股及行业分类
查询存贷款利率、货币供应量等宏观经济数据
进行交易日历相关的日期计算（上一/下一交易日、最近N日等）
支持客户端
Claude Desktop部分支持
Cursor完整支持
VS Code完整支持
Trae完整支持
CherryStudio完整支持