关键词

A股数据股票查询金融数据行情分析财务报表

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，专门用于提供中国 A 股市场的股票和宏观经济相关数据。它可以作为 LLM 客户端（如支持 MCP 的 IDE 插件或桌面应用）的后端，为其提供结构化、可调用的数据和分析能力。

主要功能点

  • 股票数据查询: 提供股票的基本信息（如名称、代码、行业）、历史 K 线数据（日、周、月、分钟线）、分红数据、复权因子等。
  • 财务数据获取: 可以查询股票的季度盈利能力、营运能力、成长能力、偿债能力、现金流量以及杜邦分析等财务指标数据。
  • 指数与行业信息: 获取特定指数（如上证50、沪深300、中证500）的成分股列表，以及股票的行业分类信息。
  • 市场概览: 获取指定日期范围内的交易日历和全部上市股票列表及交易状态。
  • 宏观经济数据: 查询存款利率、贷款利率、存款准备金率、货币供应量 (M0, M1, M2) 和 SHIBOR (上海银行间同业拆放利率) 等宏观数据。
  • 数据驱动分析: 提供一个基础的股票分析工具，结合基本面和技术面数据生成报告。
  • 最新日期识别: 提供工具帮助确定最近的交易日期和适合分析的时间范围，避免使用过时数据。

安装步骤

  1. 准备 Python 环境: 确保安装了 Python 3.10 或更高版本。
  2. 安装 uv 包管理器: 如果没有安装 uv，请先安装它（具体安装方法请参考 uv 官方文档）。
  3. 克隆项目: 将本 GitHub 仓库克隆到本地计算机。
  4. 打开终端/命令提示符: 进入到项目克隆的根目录下（包含 'pyproject.toml' 和 'mcp_server.py' 的目录）。
  5. 创建并激活虚拟环境: 执行以下命令： 
    uv venv
# Windows 系统激活：
.venv\Scripts\activate
# macOS/Linux 系统激活：
source .venv/bin/activate
  6. 安装项目依赖: 在激活的虚拟环境中执行： 
    uv sync

服务器配置

本项目是一个 MCP 服务器，它不是一个独立的桌面应用或网站。你需要一个支持 MCP 协议的客户端应用（例如 VS Code 的一些 AI 插件、CherryStudio 等）来连接并使用它。

在你的 MCP 客户端应用的设置中，找到配置 MCP 服务器的地方，并添加一个新的服务器配置。典型的配置需要以下信息：

  • 名称 (Name): 'a-share-mcp' (或任何你喜欢的名称)
  • 描述 (Description): 本地 A 股 MCP 服务器 (或任何描述)
  • 类型 (Type) / 传输协议 (Transport): 选择 'stdio' (标准输入/输出)。这是通过命令行与客户端通信的方式。
  • 命令 (Command): 填写 'uv' （或者系统中 'uv.exe' 的完整路径）。
  • 参数 (Args): 填写启动服务器所需的参数列表，每个参数作为单独一项：
    • '--directory'
    • 你的项目克隆到的绝对路径 (例如：'C:\Users\YourName\Projects\a_share_mcp' 或 '/home/yourname/projects/a_share_mcp')。请将路径中的反斜杠 '' 改为双反斜杠 '\' 如果在 Windows 系统且客户端需要。
    • 'run'
    • 'python'
    • 'mcp_server.py'
    • 例如，完整的参数列表可能是：'--directory', 'C:\Users\YourName\Projects\a_share_mcp', 'run', 'python', 'mcp_server.py'
  • 工作目录 (WorkingDirectory): 根据客户端需要，可能还需要明确指定工作目录为你项目的绝对路径。

配置完成后，在 MCP 客户端中启用这个服务器。客户端会自动启动服务器进程，并通过标准输入/输出与服务器进行通信。

基本使用方法

配置并启动服务器后，你就可以在 MCP 客户端中通过与 LLM 对话的方式来使用这个服务器提供的功能。LLM 会根据你的问题，自动识别并调用相应的工具来获取数据。

你可以尝试询问：

  • “请查询代码 'sh.600000' (浦发银行) 最近30个交易日的日 K 线数据。”
  • “'sz.000001' (平安银行) 2023年第四季度的盈利能力数据是多少？”
  • “获取上证50指数最新的成分股列表。”
  • “请查询最近一年的存款利率数据。”
  • “对 'sh.600000' 进行基本面分析。”
  • “告诉我最近的交易日期是哪天。”

请注意，LLM 调用工具的能力取决于客户端的实现和 LLM 模型的工具使用能力。数据由 Baostock 提供，其更新时间和数据范围可能存在限制，请参考 Baostock 官方说明。

信息

分类

商业系统

访问项目