共享_mcp_就是我需要的服务器

Name: 共享_mcp_就是我需要的服务器
Author: 24mlight

作者：24mlight460 星标更新：2025-09-14

安装使用来源：spider==github.com

项目介绍

📊 A股-MCP 📈

<img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=12,15,20,24&height=200&section=header&text=A%20股%20MCP&fontSize=80&fontAlignY=35&desc=基于%20Model%20Context%20Protocol%20(MCP)&descAlignY=60&animation=fadeIn" /> </div> A股MCP。

该项目是一个专注于A股市场的MCP服务器，提供各种查询功能，如基本股票信息、历史K线数据、财务指标和宏观经济数据。理论上，它可以回答与A股市场相关的任何问题，无论是整体市场还是特定股票。

项目结构

a_share_mcp/
│
├── mcp_server.py           # 主服务器入口文件
├── pyproject.toml          # 项目依赖配置
├── README.md               # 项目说明文档
│
├── docs/                   # 项目文档
│   ├── baostock_com.md     # Baostock API文档
│   ├── mcp_server_docs.md  # 服务器文档
│   └── dev_docs/           # 开发文档
│       ├── AppFlow.md
│       ├── ImplementationPlan.md
│       └── PRD.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配置示例

功能

<div align="center"> <table> <tr> <td align="center"><img src="https://gips3.baidu.com/it/u=3401531752,1684450900&fm=3081&app=3081&f=PNG?w=48&h=48" width="30px"/><br><b>股票基础数据</b></td> <td align="center"><img src="https://img.icons8.com/fluency/48/null/line-chart.png" width="30px"/><br><b>历史行情数据</b></td> <td align="center"><img src="https://gips0.baidu.com/it/u=3324534262,1283435331&fm=3081&app=3081&f=PNG?w=48&h=48" width="30px"/><br><b>财务报表数据</b></td> </tr> <tr> <td align="center"><img src="https://gips3.baidu.com/it/u=2516723908,3250460558&fm=3081&app=3081&f=PNG?w=48&h=48" width="30px"/><br><b>宏观经济数据</b></td> <td align="center"><img src="https://img.icons8.com/fluency/48/null/statistics.png" width="30px"/><br><b>指数成分股</b></td> <td align="center"><img src="https://img.icons8.com/fluency/48/null/fine-print.png" width="30px"/><br><b>数据分析报告</b></td> </tr> </table> </div>

预备条件

Python环境 Python 3.10+
依赖管理 使用 uv 包管理器安装依赖
数据源 基于Baostock数据源，无需付费账号。感谢Baostock提供的支持。
注意：此项目是在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---。

方法1：使用带有JSON配置的IDE（如Cursor、VSCode、Trae等）

对于需要编辑JSON文件来配置MCP服务器的客户端，您需要找到MCP可以配置的地方（这可能会因不同的IDE和桌面MCP客户端而异），并在 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 后，此项可能不再必需，但建议保留作为备用
    }
    // ... 其他服务器 ...
  }
}

注意事项：

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

这是一个Windows特定的情况。在macOS或Linux系统中，使用正斜杠 / 作为目录分隔符时，不需要这样的转义。
workingDirectory 尽管 uv --directory 应该解决了工作目录的问题，但如果客户端仍然报错 ModuleNotFoundError，您可以尝试显式地在客户端配置中设置此项目为项目的根目录绝对路径。

方法2：使用CherryStudio

在CherryStudio的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
- 确保所有参数之间通过按Enter键进行换行，否则会报错（这是手把手教学吗？）
环境变量 根据上述信息，执行以下指令：您是一位负责将中文内容翻译成英文的专业翻译人员。请帮我翻译原文

小技巧（必看）：有时在CherryStudio中填入参数并点击右上角的开关按钮后，可能没有响应。此时只需点击左侧目录中的任意按钮，弹出MCP设置界面，再返回MCP设置界面，就会发现MCP已经成功配置，绿灯闪烁。

CherryStudio使用示例： 理论上来说，你可以询问关于A股的任何问题

CherryStudio配置示例1

CherryStudio配置示例2

重要提示：

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

工具列表

MCP服务器提供了以下工具：

<div align="center"> <details> <summary><b>🔍 展开查看全部工具</b></summary> <br> <table> <tr> <th>🏛️ 股票市场数据</th> <th>📊 财务报表数据</th> <th>🔎 市场概览数据</th> </tr> <tr valign="top"> <td> <ul> <li><code>get_historical_k_data</code></li> <li><code>get_stock_basic_info</code></li> <li><code>get_dividend_data</code></li> <li><code>get_adjust_factor_data</code></li> </ul> </td> <td> <ul> <li><code>get_profit_data</code></li> <li><code>get_operation_data</code></li> <li><code>get_growth_data</code></li> <li><code>get_balance_data</code></li> <li><code>get_cash_flow_data</code></li> <li><code>get_dupont_data</code></li> </ul> </td> <td> <ul> <li><code>get_trade_dates</code></li> <li