使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，专注于提供中国股票市场相关的数据查询能力。它集成了 AKShare 库，将丰富的金融数据接口以 MCP 工具 (Tools) 的形式暴露出来，方便 LLM 客户端调用，从而扩展 LLM 在金融数据分析和应用方面的能力。

主要功能点

股票历史数据查询: 获取股票在不同时间粒度（分钟、小时、日、周、月、年）的历史交易数据。
股票实时数据查询: 获取股票最新的实时交易行情数据。
股票新闻数据查询: 获取与特定股票相关的最新新闻资讯。
公司财务报表查询: 获取上市公司的资产负债表、利润表和现金流量表等财务报表数据。
公司内部交易数据查询: 获取上市公司内部人员的股票交易数据。

安装步骤

克隆仓库:

git clone https://github.com/zwldarren/akshare-one-mcp.git
cd akshare-one-mcp

安装 uv: 请根据 uv 官方文档安装 uv 包管理器。
安装依赖: 在项目根目录下运行命令安装项目依赖：
```
uv sync
```
运行服务器: 在项目根目录下运行命令启动 MCP 服务器：
```
uv run main.py
```
服务器默认使用 'stdio' 传输协议，在终端中运行后即可等待 MCP 客户端连接。

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用，以下是连接 Claude Desktop 等 MCP 客户端的配置示例。客户端需要配置 MCP 服务器的启动命令 (command) 及其参数 (args) 以建立连接。

"mcpServers": {
    "akshare-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/path/to/akshare-one-mcp",  // 请替换为 akshare-one-mcp 仓库的实际路径
            "run",
            "main.py"
        ]
    }
}

配置参数说明:

'"akshare-mcp"': MCP 服务器的名称，可以自定义，在客户端中用于标识和选择该服务器。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 包管理器来运行 Python 脚本。
'"args"': 启动命令的参数列表。
- '"--directory", "/path/to/akshare-one-mcp"': 指定工作目录为 'akshare-one-mcp' 仓库的路径，请务必替换为实际的仓库路径。
- '"run", "main.py"': 指示 'uv' 运行 'main.py' 文件，即 MCP 服务器的入口脚本。

基本使用方法

启动 MCP 服务器: 按照上述 "运行服务器" 步骤启动 'akshare-one-mcp' 服务器。
配置 MCP 客户端: 将上述 "服务器配置" 中的 JSON 配置添加到 MCP 客户端的配置文件中，并确保 '"args"' 中的路径配置正确。
在 MCP 客户端中使用工具: 客户端连接成功后，即可在客户端中调用服务器提供的工具 (Tools) 来查询股票数据。例如，在支持工具调用的 LLM 应用中，可以指示 LLM 使用 'get_hist_data' 工具查询某只股票的历史数据，并指定股票代码、时间区间等参数。

具体可用的工具名称和参数请参考 'README.md' 文件中的 "Tools" 章节。

关键词