Metadata-Version: 2.4
Name: akshare_mcp
Version: 0.1.2
Summary: AKShare MCP Server
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: akshare>=1.17.26
Requires-Dist: fastmcp>=2.10.6
Description-Content-Type: text/markdown

# akshare_mcp

`AKShare`数据接口的`MCP Server`封装

## 项目背景

`AKShare`提供了上千个数据接口，但`Github`上提供的服务都只支持少量接口，所以本项目将所有接口都暴露出来，方便用户使用。

## 安装

1. 在虚拟环境下执行`pip install akshare_mcp`或`uv pip install akshare_mcp`，
2. 运行`python -m akshare_mcp -h`检查是否安装成功，留意打印的配置文件路径

## 配置

```json
{
  "mcpServers": {
    "akshare_mcp": {
      "command": "D:\\Users\\Kan\\miniconda3\\envs\\py312\\python.exe",
      "args": [
        "-m",
        "akshare_mcp",
        "--format",
        "markdown"
      ]
    }
  }
}
```

## 注意

1. 1000+接口，全部暴露成工具，将会消耗大量`Token`
2. 部分MCP客户端只支持少量的工具，例如`Trae`最多支持40个工具

所以，请一定在使用前配置需要使用的接口。

1. 运行`python -m akshare_mcp -h`，查看配置文件的位置。例如`d:\Users\Kan\miniconda3\envs\py312\Lib\site-packages\akshare_mcp\config.py`
2. 编辑配置文件`config.py`，添加需要使用的接口。接口名参考`https://akshare.akfamily.xyz/data/index.html`
3. MCP客户端刷新重连服务端

如果`site-packages\akshare_mcp\config.py`无权限修改，可以从`github`上复制`config.py`文件到任意路径，然后使用`--config`参数

```commandline
python -m akshare_mcp --config D:\config.py
```