Google Play Console MCP

一个用于 Google Play Console 的 MCP 服务器 —— 涵盖发布、Android 运行状况、收入、ASO 与商店素材的 169 个工具，且每个破坏性写入操作都带有确认门禁。

将 Claude、Cursor、VS Code、Codex、Gemini CLI、Windsurf 或任何 Model Context Protocol 客户端连接到你的 Google Play 开发者账号。

发布一个版本。查询它是否正在崩溃。了解它的收入。查看用户搜索了哪些词才找到它。回复一条评论。所有这些都可以在同一个会话中完成，而且所有破坏性操作都必须先经过你的确认。

"Is the 4.2.1 rollout healthy?"
  -> vitals freshness checked, crash rate by version code, worst issue's stack
     trace, current rollout fraction — and a recommendation

"How much did we make in July, and where did the installs come from?"
  -> earnings per currency, acquisitions by traffic source, top search terms

"Ship 4.2.2 to production at 10%."
  -> a preview you have to approve before anything moves

为什么选择这个

市面上已有十几个 Google Play MCP 服务器。这是唯一一个覆盖整个功能面的，也是唯一一个拥有真正测试套件的。

大多数服务器只是封装了 Android Publisher API 就止步了。该 API 无法告诉你崩溃率，无法告诉你收入，也无法告诉你用户输入了哪些词来找到你的应用——这些数据完全存在于另外两个地方。

Related MCP server: MCP Google Play Store Server

五个层面

每一项都需要不同的凭据，而服务器会准确告诉你缺失了哪些以及如何修复。

安装

uvx google-play-console-mcp          # no install
pipx install google-play-console-mcp # or install it
pip install google-play-console-mcp

配置

添加到你的 MCP 客户端配置文件（.mcp.json、claude_desktop_config.json, …）：

{
  "mcpServers": {
    "google-play": {
      "command": "uvx",
      "args": ["google-play-console-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
        "GOOGLE_PLAY_MCP_REPORTS_BUCKET": "pubsite_prod_rev_0123456789"
      }
    }
  }
}

凭据

1. 服务账号 — 在 Google Cloud Console 中启用 Google Play Android Developer API → 创建服务账号 → 下载 JSON 密钥。

2. 在 Play Console → 用户和权限中将该账号邀请进去。

3. 授权以下权限，这些权限是独立的，且很容易遗漏其中一个：

批量报告权限是账号级别的。应用级别的授权无法访问存储桶，这也是这些工具返回 403 的常见原因。

在 Play Console → 下载报告 → Channel 报告名 → 找到存储桶。没有 API 能发现它。

如果你的报告存在，请让助手运行 check_reports_access，或直接阅读 gplay://config 这个资源——两者都会报告哪些内容已配置好，以及缺失部分需要什么。

安全性

这个服务器可以发布到生产环境、删除所有本地化列表，以及退款给真实用户。因此很有必要说明以下几点：

18 个破坏性工具位于一个两步确认门之后。 第一次调用会返回一个预览——它将带来哪些修改、会影响哪些内容、如何撤销——并且不会执行任何操作。只有第二次调用携带该预览的令牌时才执行操作。

该构造是基于操作的标准指纹的 HMAC，并使用仅安装时生成的密钥进行签名，而模型本身无法看到该密钥。它会拦截非法令牌、来自不同操作的令牌、预览与确认之间参数被的令牌、重复使用的令牌以及已过期的令牌。

其风险模型不是恶意用户，而是一个模型会幻觉确认令牌、重复前面旧令牌、在预览和确认之间调整某个参数，并且会破坏愉快地告知你“你已经批准了”一个你从未见过的东西。

halt_release 是刻意不加 防护的。 停止一个异常版本是在缩减爆炸半径的唯一一个操作。在故障期间，要求再一次往返本身就是一种故障模式。

生产环境的发布不能一步到 100%。 分阶段发布策略将第一步上限为 20%；要让所有用户都更新，需要使用单独命名的扩大工具。这个比例可以收紧上限，但不能禁用或跳过。

一切都被审计 —— 无论是预览、确认、拒绝、执行成功还是失败 —— 都会记录到 ~/.google-play-mcp/audit.jsonl，并会擦除所有私密信息。

GOOGLE_PLAY_MCP_READ_ONLY=1 会直接拒绝所有写入，适合在纯探索性会话中使用。

详见 写入安全性。

不来不知道的经验

• 截图不能有 Alpha 通道，而图标必须有。” 普通的 “PNG” 导出是 RGBA 格式——这对图标是对的，但其他素材会直接“带通”。preflight_store_image 可以在一次六十张图片的打包在直接上传失败之前就发现问题。

• Play 要求每个语言区域、每个类型至少两张截图。 只有一张的截图在文件级别是有效，却需阻止你发布新版本。

• 订阅购买如果在三天内未确认，会被 Google 自动退款并撤消。 这是一种静默的财务损失。会

• API 接受 50 个字符的标题；Play 政策上限是 30。 它可以照常上传，但在审核时会被拒。

• 分发数据延迟数小时到数天。不可信。 一个查询 7 天却只返回 5 天的数据，你读到的是“改善”而不是“数据缺口”，所以数据时效性是一流的、最重要的工具。

• 月收入要到下月 5 号左右才会发布。 没有这一点，你的“$0”看起来是崩溃而不是数据缺失，查询它。

• 收入绝不能跨币种进行加总 — 1000 日元和 10 欧元相加是一个看起来正确的错误答案。

• com.acme.free 绝不能被 com.acme.freemium 的收入。归因就被算到一个包段边界为止。

工具

169 个工具。完整参考见官方文档。

另附 2 个提示词（publish_screenshots、publish_health_check）、release_healthcheck）和 4 个资源。

已测试

1,198 tests · 100% line and branch coverage · 15 modules
ruff clean · mypy clean · every release gated at --cov-fail-under=100

全套测试中没有任何真实 API 调用。报告解析针对真实 UTF-16 字节进行测试，素材预检针对真实 PNG 和 JPEG 头。

超出范围

截图生成 — 可使用 appscreens 或 任何其他工具生成后，再在此处进行预检和上传。

开源协议

Apache-2.0。

关键词：google play console mcp， google play mcp server， android publisher api mcp， play developer api， 模型上下文协议 google play 该项目， android app 发布自动化， android vitals mcp， play console api claude， aso mcp， google play 收入 api， play store 签名 api， android 发布 agent