A-Share MCP Server

社区

基于 Baostock 数据源的中国 A 股行情与财务数据 MCP 服务器

分类: 其他第 42 / 230
Stars: ★ 646 热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · 预编译二进制 uv package manager
凭据: 无需凭据
许可证: MIT
最近提交: 10 个月前 ⚠
工具数: 41

64FMRS · C

该服务器功能覆盖面广（41个工具），聚焦中国 A 股的行情、财务与宏观数据查询，安装配置需手动填写绝对路径且以 Windows 环境为主要开发和验证平台，适合个人开发者和研究场景，但缺乏身份验证且依赖免费第三方数据源，不适合对数据时效性和可靠性要求较高的生产环境。

最强项 · 文档质量 16/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

15/20

维护活跃度

12/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: README 列出了 41 个工具及其分类，结构清晰，但仓库中未提供可验证的测试用例、CI 配置或错误处理说明；文档也未说明各工具在数据缺失、接口超时或参数错误时的行为。由于是静态审查且无法执行验证，也未见到测试/CI 证据，按规则不能给出高于 12 的分数；考虑到功能描述具体、合理但完全未经验证，给予 7 分。
安全与权限 15/20: 该服务基于免费的 Baostock 数据源，全部工具均为只读式市场/财务数据查询（K线、财务报表、宏观数据等），未见涉及凭证存储、资金操作、文件写入或不可逆的破坏性动作，也没有需要额外网络出站权限的迹象，红线风险低。但文档未明确说明权限范围、数据边界、输入校验或潜在的滥用防护措施，也未讨论请求速率限制或第三方数据合规问题，故未给满分，扣分体现在权限与数据边界披露不完整，给予 15 分。
维护活跃度 12/20: 项目使用 MIT 许可证，具备一定关注度（646 星，17 个未关闭 issue，未被归档），并且 README 中记录了 2025-12-25 的一次功能更新（新增 get_fina_indicator 工具），显示出一定的持续维护迹象。但缺乏发布版本历史、提交频率、issue 响应时效、依赖升级策略或安全响应渠道的具体信息，治理与版本化方面证据不足，给予 12 分。
文档质量 16/20: README 内容较为详尽，包含项目结构说明、先决条件、Baostock 数据更新时间表、安装步骤（uv venv/uv sync）、两种主流客户端（JSON 配置、CherryStudio）的具体配置示例，以及完整的 41 个工具列表（按类别分组并附中文说明）。不足之处在于未提供每个工具的具体参数、返回格式、速率限制、错误码或专门的故障排查章节，跨平台（尤其是非 Windows）细节也较简略，给予 16 分。
安装易用性 14/20: 安装步骤明确、简短（创建虚拟环境、uv sync、编写 JSON 或 CherryStudio 配置），并给出了具体的配置示例和路径转义提示，理论上降低了配置门槛。但主要面向 Windows 环境编写和测试（README 明确说明'本项目于 Windows 环境下开发'），未见针对 macOS/Linux 的完整验证信息，且未提供任何自动化安装脚本、CI 冒烟测试或安装脚本执行证据，按静态审查规则该维度不能超过 15 分，给予 14 分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要程序化查询 A 股行情与财务数据的开发者
在 AI 助手中做 A 股相关问答或数据分析研究的用户
希望免费、无需申请付费账号即可获取 A 股数据的个人使用场景

不适合谁

需要实时（分钟级）盘口或逐笔行情的高频交易场景
需要港股、美股等非 A 股市场数据的用户
对数据准确性/时效性有严格合规要求的机构级生产环境（数据源为免费的 Baostock，非官方保证）

所需权限

运行 Python 进程并通过 uv 执行本地脚本
对外网络访问，用于从 Baostock 拉取行情与财务数据
无需配置任何 API 密钥或账号

风险与副作用

数据来自第三方免费数据源 Baostock，非官方维护，数据更新存在延迟（如当日K线需17:30后才入库）
项目主要在 Windows 环境下开发和测试，跨平台（macOS/Linux）兼容性未充分验证
无身份验证机制，任何能访问该 MCP 服务的客户端均可调用全部工具及查询数据
若 Baostock 接口发生变更，可能导致部分工具失效且无官方支持保障

安装接入

准备工作

运行环境：Python 3.10+ · 预编译二进制 uv package manager

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"}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "a-share-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/a_share_mcp",
        "run",
        "python",
        "mcp_server.py"
      ],
      "transport": "stdio"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add a-share-mcp -- uv --directory /path/to/a_share_mcp run python mcp_server.py

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端配置完成后，检查工具列表中是否出现 get_historical_k_data 等工具；也可以直接提问“今天是不是交易日”，若 is_trading_day 返回结果即说明连接成功。

常见排障

出现 ModuleNotFoundError 时，检查是否已执行 `uv sync` 安装依赖，并尝试在客户端配置中显式设置 workingDirectory 为项目根目录
确认 `command` 中的 uv 路径客户端可执行访问，必要时改用 uv.exe 的绝对路径
Windows 路径需使用双反斜杠转义（如 `C:\\Users\\...`），macOS/Linux 使用正斜杠且无需转义
查询当日数据无返回或数据缺失时，注意 Baostock 官方数据入库时间点（如日K线17:30后、分钟K线次日11:00后）
CherryStudio 中配置后开关无反应，可尝试切换到其他菜单再返回 MCP 设置页面刷新状态

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查询贵州茅台最近30天的历史K线数据
列出沪深300指数的全部成分股
帮我查一下平安银行本季度的财务指标汇总
今天是不是交易日？最近的交易日是哪天？

工具能力 41

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 只读

展开其余 33 个工具

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 只读

使用场景

查询个股历史K线、复权因子与分红配送数据

获取上市公司盈利能力、成长能力、偿债能力等财务指标

查看上证50、沪深300、中证500等指数成分股及行业分类

查询存贷款利率、货币供应量等宏观经济数据

进行交易日历相关的日期计算（上一/下一交易日、最近N日等）

支持客户端

Claude Desktop部分支持

Cursor

VS Code

Trae

CherryStudio

依据项目文档列出，未经本站实测。

详细介绍

a-share-mcp 是一个面向中国 A 股市场的 MCP 服务器，基于免费的 Baostock 数据源，通过 41 个工具提供股票基础信息、历史 K 线、复权因子、分红配送、六大类财务指标（盈利、营运、成长、偿债、现金流、杜邦分析）、业绩快报与预告、指数成分股（上证50、沪深300、中证500）、行业分类、宏观经济数据（存贷款利率、存款准备金率、货币供应量）以及交易日历/日期计算等工具，理论上可以回答关于 A 股大盘或个股的绝大多数数据类问题。项目以 Python 编写，使用 uv 管理依赖，通过 stdio 传输与 MCP 客户端通信。