使用说明

项目简介

AKShare MCP服务器是一个实现了 Model Context Protocol (MCP) 的应用后端，它利用强大的 AKShare 金融数据接口库，为大型语言模型 (LLM) 客户端提供丰富的金融数据查询能力。通过标准化的 MCP 协议，该服务器可以无缝集成到支持 MCP 协议的 LLM 应用中，例如 Claude Desktop，使得 LLM 能够便捷地获取和利用实时的金融市场数据进行分析和应用。

主要功能点

金融数据访问: 提供中国及全球金融市场的股票、指数、基金、期货、债券、外汇、宏观经济数据等多种数据类型的访问接口。
工具化数据查询: 将各种数据查询功能封装成独立的工具 (Tools)，LLM 客户端可以按需调用这些工具来获取特定金融数据。
MCP 协议支持: 完全遵循 MCP 协议标准，能够与任何兼容 MCP 协议的客户端进行通信和集成。
易于扩展: 通过简单的步骤即可添加新的金融数据查询工具，方便用户根据自身需求扩展服务器功能。
示例集成配置: 提供详细的 Claude Desktop 集成配置示例，方便用户快速上手使用。

安装步骤

克隆仓库

git clone https://github.com/ttjslbz001/akshare_mcp_server.git
cd akshare_mcp_server

创建并激活虚拟环境

python -m venv venv
source venv/bin/activate   # Linux/macOS
# venv\Scripts\activate  # Windows

安装依赖 推荐使用 'uv' (如果已安装uv):

uv pip install -e .

或者使用 'pip':

pip install -e .

服务器配置

要将 AKShare MCP 服务器与 MCP 客户端（例如 Claude Desktop）集成，您需要在客户端的配置文件中添加服务器配置信息。以下是 Claude Desktop 的配置示例，其他 MCP 客户端的配置方式类似。

Claude Desktop 配置示例 (JSON 格式):

"mcpServers": {
    "akshare-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/path/to/akshare_mcp_server",  // 替换为 akshare_mcp_server 仓库的实际路径
            "run",
            "akshare-mcp"
        ],
        "env": {
            "AKSHARE_API_KEY": "<your_api_key_if_needed>" // 如果 AKShare API 需要 API 密钥，请在此处配置
        }
    }
}

配置参数说明:

'"akshare-mcp"': 服务器名称，可以自定义。
'"command": "uv"': 启动服务器的命令，这里假设您使用 'uv' 运行，如果使用 'pip' 安装，可以替换为 'python'。
'"args"': 传递给启动命令的参数列表。
- '"--directory", "/path/to/akshare_mcp_server"': 指定服务器代码所在的目录，请替换为实际路径。
- '"run", "akshare-mcp"': 运行 'run_server.py' 文件。
'"env"': 环境变量配置，例如可以配置 AKShare 的 API 密钥（如果需要）。

注意:

请将 '/path/to/akshare_mcp_server' 替换为您本地 'akshare_mcp_server' 仓库的实际绝对路径。
如果您没有安装 'uv'，并且使用 'pip' 安装的依赖，可以将 '"command": "uv"' 和 '"args"' 修改为 '"command": "python", "args": ["run_server.py"]'。
'AKSHARE_API_KEY' 环境变量是可选的，仅在 AKShare 接口需要 API 密钥时才需要配置。

基本使用方法

启动服务器 激活虚拟环境后，在 'akshare_mcp_server' 仓库目录下运行命令：
```
python run_server.py
```
或 (如果使用 uv 配置)
```
uv run akshare-mcp
```
服务器成功启动后，会显示 "Starting AKShare MCP server..." 的信息。
在 MCP 客户端中使用
- 确保您的 MCP 客户端（例如 Claude Desktop）已正确配置并连接到 AKShare MCP 服务器。
- 在客户端中，您应该能够看到 AKShare MCP 服务器提供的工具列表。
- 选择您需要的工具，并根据工具的参数描述输入相应的参数，即可调用 AKShare MCP 服务器获取金融数据。
- 服务器返回的数据将以 JSON 格式呈现给客户端。

通过以上步骤，您就可以成功安装、配置和使用 AKShare MCP 服务器，为您的 LLM 应用提供强大的金融数据支持。

关键词