蒲公英 MCP

在支持 Model Context Protocol 的 AI 客户端中上传应用、查询应用和历史版本、设置最新版本，以及修改应用设置。

Model Context Protocol（MCP）是一套让 AI 助手通过标准化接口调用外部工具的开放协议。蒲公英 MCP 服务器由官方命令行工具 @pgyer/cli 提供（pgyer mcp 命令），把上传应用、查询应用和历史版本等能力封装为 MCP 工具，可以在 Claude Code、Claude Desktop、Cursor、VS Code、Codex 等客户端中用自然语言调用。

源码和完整说明见 GitHub 仓库 PGYER/pgyer-cli。

如需选择 API、CLI、CI/CD 插件、MCP 或 Agent Skill，请先查看自动上传 App 与 CI/CD 集成指南。

前置要求

Node.js 20.19 或更高版本（npx 需要）。
蒲公英 API Key：可以在 API 信息页面查看。尚未实名认证的账户需要先完成认证。

客户端配置

以下配置通过 npx -y @pgyer/cli mcp 启动服务器，无需预先安装。已全局安装 CLI 并执行过 pgyer auth login 时，也可以把命令换成 pgyer mcp 并省略 PGYER_API_KEY。

Claude Code

claude mcp add pgyer --env PGYER_API_KEY=YOUR_API_KEY -- npx -y @pgyer/cli mcp

Claude Desktop 与 Cursor

在 Claude Desktop 的 claude_desktop_config.json，或 Cursor 的 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "pgyer": {
      "command": "npx",
      "args": ["-y", "@pgyer/cli", "mcp"],
      "env": {
        "PGYER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Codex

codex mcp add pgyer --env PGYER_API_KEY=YOUR_API_KEY -- npx -y @pgyer/cli mcp

VS Code 等其他客户端的配置见 CLI 说明。

旧配置中的 npx -y pgyer-mcp-server 会启动同一个服务器，可以继续使用。

可用工具

工具	作用
`upload_app`	上传 `.apk`、`.ipa` 或 `.hap` 安装包，可设置更新说明、安装方式、安装密码、有效期和渠道，返回下载页地址和二维码
`get_upload_status`	按 buildKey 查询发布进度
`list_apps`	列出账户中的应用
`get_app`	按 App Key 或短链接查看应用详情
`list_versions`	查看应用的历史版本
`set_latest_version`	设置或取消下载页显示的版本
`update_app_settings`	修改应用设置，可以先预览修改内容

MCP 服务器不提供删除工具，也不会返回安装密码。修改类工具会被标注为会改动数据，客户端通常会在调用前请您确认。

使用示例

配置完成后，在客户端中用自然语言描述任务即可，例如：

示例提示词

把 app/build/outputs/apk/release/app-release.apk 上传到蒲公英，更新说明写“修复登录崩溃”，安装方式设为密码安装，密码为 123456。

AI 助手会调用 upload_app 完成上传，并返回下载页地址和二维码。