项目简介

AKShare 是一个开源的财经数据接口库，提供了国内股票、期货、期权、基金、债券、外汇等多种金融市场的实时及历史数据。本项目 'akshare_mcp' 将 AKShare 提供的上千个数据接口封装成符合 Model Context Protocol (MCP) 标准的工具 (Tools)，使得支持 MCP 的 LLM 客户端（如 Trae）能够直接调用这些工具来获取和处理金融数据。

主要功能点

海量数据接口转工具: 将 AKShare 中超过 1000 个数据接口动态转换为 MCP 工具。
工具接口配置: 支持通过配置文件 ('config.py') 指定需要暴露的 AKShare 接口白名单或黑名单，以控制工具数量，适应不同 MCP 客户端的限制或减少不必要的 Token 消耗。
多种输出格式: 支持将数据工具的返回结果格式化为 Markdown、CSV 或 JSON，方便 LLM 理解和处理。
标准 MCP 协议: 基于 FastMCP 库实现，遵循 MCP 规范，确保与 MCP 客户端的兼容性。

安装步骤

确保你已经安装了 Python (推荐 3.8+ 版本) 和 pip 或 uv。
打开终端或命令提示符。

在一个虚拟环境中执行以下命令进行安装：

pip install akshare_mcp
# 或使用 uv
# uv pip install akshare_mcp

安装成功后，你可以运行以下命令检查是否安装成功，并查找配置文件 'config.py' 的位置：
```
python -m akshare_mcp -h
```
命令输出会显示配置文件的路径，通常位于你的 Python 环境的 'site-packages/akshare_mcp/config.py'。

服务器配置 (为 MCP 客户端准备)

MCP 服务器主要由 MCP 客户端负责启动和管理。你需要将 'akshare_mcp' 服务器的启动信息配置到你的 MCP 客户端中。典型的配置是一个 JSON 结构，指定服务器的名称、启动命令及其参数。

以下是一个示例配置结构，你需要根据你的实际安装路径填写 'command' 字段：

// 这段配置通常位于你的 MCP 客户端的配置文件中，请勿直接修改本项目文件
{
  "mcpServers": {
    "akshare_data_server": { // 服务器名称，你可以自定义
      "command": "你的Python解释器完整路径", // 例如: "C:\\Users\\YourName\\AppData\\Local\\Programs\\Python\\Python310\\python.exe" 或 "/usr/bin/python3"
      "args": [
        "-m",           // 表示将 akshare_mcp 作为一个模块运行
        "akshare_mcp",
        "--format",     // 指定数据输出格式，可选 markdown, csv, json
        "markdown"      // 默认使用 markdown 格式
        // 其他参数，如 --transport, --host, --port，通常使用默认值或由客户端管理
      ]
    }
    // 如果有其他 MCP 服务器，可以继续添加
  }
}

请将上述 'command' 字段替换为你系统中安装了 'akshare_mcp' 的那个 Python 解释器的完整路径。'args' 列表中的参数控制服务器的启动行为，'--format' 参数尤其重要，它决定了工具返回数据的格式。

基本使用方法

启动服务器: 通常情况下，你无需手动启动 'akshare_mcp' 服务器。配置好 MCP 客户端后，当客户端需要使用 'akshare_mcp' 提供的工具时，会自动按照配置中的 'command' 和 'args' 启动服务器。
配置暴露的接口: 由于 AKShare 接口数量众多，为了提高效率和兼容性，强烈建议配置你需要使用的接口。
- 找到安装步骤中提及的 'akshare_mcp/config.py' 配置文件。
- 编辑该文件，将你需要的 AKShare 函数名（参考 AKShare 官方文档）添加到 'white_list' 列表中。如果 'white_list' 不为空，将只注册白名单中的函数。
- 或者，将不需要的函数添加到 'black_list' 中。
- 保存 'config.py' 文件。
- 重新启动你的 MCP 客户端，以便它加载新的配置并启动服务器。
通过 LLM 客户端调用: 在支持 MCP 工具调用的 LLM 客户端中，LLM 即可识别并调用 'akshare_mcp' 暴露的工具来获取金融数据。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (为 MCP 客户端准备)

基本使用方法

信息