A股mcp。

本项目是一个基于专注于 A 股市场的 MCP 服务器，它提供股票基本信息、历史 K 线数据、财务指标、宏观经济数据等多种查询功能，理论上来说，可以回答有关 A 股市场的任何问题，无论是针对大盘还是特定股票。

项目结构

a_share_mcp/
│
├── mcp_server.py           # 主服务器入口文件
├── pyproject.toml          # 项目依赖配置
├── README.md               # 项目说明文档
│
├── src/                    # 源代码目录
│   ├── __init__.py
│   ├── baostock_data_source.py   # Baostock数据源实现
│   ├── data_source_interface.py  # 数据源接口定义
│   ├── utils.py                  # 通用工具函数
│   │
│   ├── formatting/         # 数据格式化模块
│   │   ├── __init__.py
│   │   └── markdown_formatter.py  # Markdown格式化工具
│   │
│   └── tools/              # MCP工具模块
│       ├── __init__.py
│       ├── base.py                # 基础工具函数
│       ├── stock_market.py        # 股票市场数据工具
│       ├── financial_reports.py   # 财务报表工具
│       ├── indices.py             # 指数相关工具
│       ├── market_overview.py     # 市场概览工具
│       ├── macroeconomic.py       # 宏观经济数据工具
│       ├── date_utils.py          # 日期工具
│       └── analysis.py            # 分析工具
│
└── resource/               # 资源文件
    └── img/                # 图片资源
        ├── img_1.png       # CherryStudio配置示例
        └── img_2.png       # CherryStudio配置示例

功能特点

先决条件

1. Python 环境: Python 3.10+
2. 依赖管理: 使用 uv 包管理器安装依赖
3. 数据来源: 基于 Baostock 数据源，无需付费账号。在此感谢 Baostock。
4. 提醒：本项目于 Windows 环境下开发。

数据更新时间

以下是 Baostock 官方数据更新时间，请注意查询最新数据时的时间点 Baostock 官网

每日数据更新时间：

• 当前交易日 17:30，完成日 K 线数据入库
• 当前交易日 18:00，完成复权因子数据入库
• 第二自然日 11:00，完成分钟 K 线数据入库
• 第二自然日 1:30，完成前交易日"其它财务报告数据"入库
• 周六 17:30，完成周线数据入库

每周数据更新时间：

• 每周一下午，完成上证 50 成份股、沪深 300 成份股、中证 500 成份股信息数据入库

所以说，在交易日的当天，如果是在 17:30 之前询问当天的数据，是无法获取到的。

安装环境

在项目根目录下执行：

要启动 A 股 MCP 服务器，请按照以下步骤操作：

# 1. 创建虚拟环境（仅创建，不会安装任何包）
uv venv

# 2. 激活虚拟环境
# Windows
.venv\Scripts\activate
# macOS/Linux
# source .venv/bin/activate

# 3. 安装所有依赖（必须在激活的虚拟环境中执行）
uv sync

使用：在 MCP 客户端中配置服务器

在支持 MCP 的客户端（如 VS Code 插件、CherryStudio 等）中，你需要配置如何启动此服务器。 推荐使用 uv。

方法一：使用 JSON 配置的 IDE (例如 Cursor、VSCode、Trae 等)

对于需要编辑 JSON 文件来配置 MCP 服务器的客户端，你需要找到对应的能配置 MCP 的地方（各个 IDE 和桌面 MCP Client 可能都不一样），并在 mcpServers 对象中添加一个新的条目。

JSON 配置示例 (请将路径替换为你的实际绝对路径):

{
  "mcpServers": {
    "a-share-mcp": {
      "command": "uv", // 或者 uv.exe 的绝对路径, 例如: "C:\\path\\to\\uv.exe"
      "args": [
        "--directory",
        "C:\\Users\\YourName\\Projects\\a_share_mcp", // 替换为你的项目根目录绝对路径，不一定是C盘，按实际的填写
        "run",
        "python",
        "mcp_server.py"
      ],
      "transport": "stdio"
      // "workingDirectory": "C:\\Users\\YourName\\Projects\\a_share_mcp", // 使用 uv --directory 后，此项可能不再必需，但建议保留作为备用
    }
    // ... other servers ...
  }
}

注意事项:

• command: 确保填写的 uv 命令或 uv.exe 的绝对路径是客户端可以访问和执行的。
• args: 确保参数列表完整且顺序正确。
• 路径转义: 路径需要写成双反斜杠 \\。

  这是 Windows 系统特有的情况。如果是在 macOS 或 Linux 系统中，路径使用正斜杠/作为目录分隔符，就不需要这种转义处理。

• workingDirectory: 虽然 uv --directory 应该能解决工作目录问题，但如果客户端仍然报错 ModuleNotFoundError，可以尝试在客户端配置中明确设置此项为项目根目录的绝对路径。

方法二：使用 CherryStudio

在 CherryStudio 的 MCP 服务器配置界面中，按如下方式填写：

• 名称: a-share-mcp (或自定义)

• 描述: 本地 A 股 MCP 服务器 (或自定义)

• 类型: 选择 标准输入/输出 (stdio)

• 命令: uv (或者填系统中绝对路径下 uv.exe)

• 包管理源: 默认

• 参数:

  1. 第一个参数填: --directory
  2. 第二个参数填: C:\\Users\\YourName\\Projects\\a_share_mcp
  3. 第三个参数填: run
  4. 第四个参数填: python
  5. 第五个参数填: mcp_server.py
  • 确保所有参数按下回车转行隔开的，否则报错（是不是手把手教学了？）

• 环境变量: (通常留空)

Tricks（必看）: 有时候在 Cherrystudio 填写好参数后，点击右上方的开关按钮，会发现没任何反应，此时只要随便点击左侧目录任一按钮，跳出 mcp 设置界面，然后再回到 mcp 设置界面，就会发现 mcp 已经闪绿灯配置成功了。

CherryStudio 使用示例: 理论上来说，你可以问有关 A 股的任何问题 :)

重要提示:

• 确保命令字段中的 uv 或其绝对路径有效且可执行。
• 确保参数字段按顺序正确填写了五个参数。

工具列表

该 MCP 服务器目前提供 41 个工具，覆盖股票、财报、宏观、日期分析等全方位数据。以下是完整列表：

贡献指南

欢迎提交 Issue 或 Pull Request 来帮助改进项目。贡献前请先查看现有 Issue 和文档。

☕️ 请作者喝杯咖啡

如果这个项目对你有帮助，欢迎请我喝杯咖啡 ❤️

许可证

本项目采用 MIT 许可证 - 详情请查看 LICENSE 文件

本次更新概览（2025-12-25）

本次更新新增 财务指标汇总工具，将 6 大类财务数据聚合为一个便捷查询接口。

🆕 新增工具

• 财务指标汇总: get_fina_indicator 一键获取 6 大类财务指标（盈利能力、营运能力、成长能力、偿债能力、现金流量、杜邦分析），按季度返回合并数据。

a-share-mcp 快速上手指南

本项目是一个基于 Model Context Protocol (MCP) 的 A 股数据服务器，提供股票基础信息、历史 K 线、财务报表及宏观经济等全方位数据查询功能。数据源采用免费的 Baostock，无需付费账号。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Windows (项目主要开发环境), macOS, Linux
• Python 版本: Python 3.10+ (推荐 3.12+)
• 包管理器: uv (高性能 Python 包管理工具)
  • 安装 uv (官方脚本):

    curl -LsSf https://astral.sh/uv/install.sh | sh
    

  • 或 Windows PowerShell:

    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
    

2. 安装步骤

请在项目根目录下执行以下命令来配置运行环境：

# 1. 创建虚拟环境
uv venv

# 2. 激活虚拟环境
# Windows 系统
.venv\Scripts\activate
# macOS / Linux 系统
source .venv/bin/activate

# 3. 安装项目依赖
uv sync

3. 基本使用

本工具需作为 MCP Server 在支持 MCP 协议的客户端（如 Cursor, VS Code, CherryStudio 等）中配置使用。

配置方式一：JSON 配置文件 (适用于 Cursor, VS Code, Trae 等)

在客户端的 MCP 配置文件中添加以下条目。注意替换 args 中的绝对路径为您本地的项目实际路径。

{
  "mcpServers": {
    "a-share-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\YourName\\Projects\\a_share_mcp", 
        "run",
        "python",
        "mcp_server.py"
      ],
      "transport": "stdio"
    }
  }
}

注意：Windows 路径需使用双反斜杠 \\ 转义；macOS/Linux 使用正斜杠 /。

配置方式二：CherryStudio 图形界面

如果您使用 CherryStudio，请在 MCP 服务器设置界面按以下参数填写：

• 名称: a-share-mcp
• 类型: 标准输入/输出 (stdio)
• 命令: uv (若未配置环境变量，请填写 uv.exe 的绝对路径)
• 参数 (需分五行填写):
  1. --directory
  2. C:\Users\YourName\Projects\a_share_mcp (替换为您的项目绝对路径)
  3. run
  4. python
  5. mcp_server.py

提示: 配置完成后若状态灯未变绿，尝试切换左侧菜单再返回刷新状态。

使用示例

配置成功并重启客户端后，您可以在对话框中直接询问 A 股相关问题，例如：

• “查询贵州茅台最近一年的历史 K 线数据。”
• “展示沪深 300 指数的成分股列表。”
• “分析宁德时代最新的财务报表和盈利能力指标。”
• “获取当前的存款准备金率和货币供应量数据。”

服务器将自动调用对应的 41 个工具（如 get_historical_k_data, get_profit_data 等）返回结构化数据和分析结果。