AKBridge MCP server

<!-- mcp-name: io.github.kevynf/akbridge --> AKBridge 将 AKShare 公共接口自动接入 MCP。 简体中文 | English

安装 | 客户端配置 | 调用示例

将 AKShare 公共接口自动暴露为 MCP 工具，并提供路由检索、结构化输出、逐接口验收以及自动化验收与维护。当前 AKShare 基线版本、接口数量和验收结果由自动化报告记录。

为什么选择 AKBridge

AKShare 提供了覆盖广泛的金融数据接口，但把它直接接入 AI 助手仍需要处理 Python 调用、函数选择、参数构造、DataFrame 转换以及版本变化。AKBridge 将这些工作收敛为一个可安装、可检索、可验收的 MCP 服务，让支持 MCP 的 LLM 客户端、Agent 或其他工具可以直接使用 AKShare，而不必为每个应用重复编写适配代码。

AKBridge 适合需要构建金融研究助手、行情分析 Agent、数据检索工具或其他 LLM 金融应用的开发者，尤其适用于以下场景：

• 希望覆盖 AKShare 的完整公共接口，而不是长期手工维护少量工具；
• 希望用户通过自然语言提出需求，由支持 MCP 的 LLM 客户端、Agent 或其他工具完成接口检索和结构化调用；
• 希望只向 LLM 暴露少量稳定的路由工具，降低上千个接口带来的上下文压力；
• 希望获得统一的 JSON 输出、分页、摘要和错误分类，而不是直接处理不同形态的 Python 返回值；
• 希望在 AKShare 更新后自动发现接口变化，并通过逐接口验收判断是否仍可安全使用。

AKBridge 不替代 AKShare：AKShare 负责数据获取，AKBridge 负责把这些能力可靠地交给支持 MCP 的 LLM 客户端、Agent 或其他工具。第三方数据源自身的登录、验证码、反爬、限流和网络限制仍然存在，并会被单独报告。

验收状态

状态图由验收报告命令自动生成，详细结果见中文验收汇总、English acceptance summary和逐接口明细。

自动化维护

AKBridge 使用 GitHub Actions 和 Dependabot 自动检查 AKShare 更新；同一主版本升级在完整验收通过后自动合并。具体频率、门禁和仓库配置见自动化验收与维护说明。

功能

• 自动发现 AKShare 公共可调用接口，无需手工维护上千个适配器。
• 根据 Python 函数签名生成 MCP 输入 Schema。
• 支持 DataFrame、Series、日期和常见 NumPy 标量的 JSON 转换。
• 支持 DataFrame JSON 入参及时间索引转换。
• 提供逐接口隔离验收、超时控制、并发执行、验收参数集和断点续跑。
• 生成逐接口 CSV 明细以及 JSON、Markdown 汇总报告。
• 提供本地语义目录、确定性检索和三工具路由模式，避免把全部原始工具同时放入模型上下文。
• 支持 raw、compact、summary 三种输出模式、分页、字段类型和单位提示。
• 提供重试、限速、缓存、熔断、代理配置、敏感信息脱敏以及自动化验收与维护门禁。

安装

推荐使用 uv 独立安装命令行工具。uv 会为 AKBridge 管理隔离的 Python 3.11+ 环境，不需要把依赖安装到系统 Python。

普通用户请从 PyPI 安装最新发布版：

uv tool install akbridge
uv tool update-shell

重新打开终端后验证安装：

akbridge --help
akbridge --mode router

第二条命令会启动 stdio MCP 服务并等待客户端连接，因此终端看起来没有继续输出是正常现象，可按 Ctrl+C 停止。

如需安装 GitHub 默认分支上的开发版本，可使用：

uv tool install --force "git+https://github.com/kevynf/akbridge.git"

更新或卸载：

# PyPI 安装：升级到最新已发布版本
uv tool upgrade akbridge

uv tool uninstall akbridge

从源码运行

只有参与开发或需要修改代码时才需要克隆仓库：

git clone https://github.com/kevynf/akbridge.git
cd akbridge
uv sync --group dev
uv run --no-sync akbridge --mode router

stdio 服务启动后通常不会显示网页、菜单或命令提示符。MCP 客户端会通过标准输入输出与该进程通信。

两种工具模式

all 是默认模式，保留所有已发现的 AKShare 原始函数工具，适合兼容已有客户端、逐接口验收和人工精确调用：

akbridge --mode all

实际连接 LLM 时建议使用 router 模式。它只向客户端公布三个稳定工具：

Shortened. The full README is on GitHub.