Google Play Console MCP

谷歌游戏控制台MCP


 ](https://lobehub.com/mcp/agimaulana-googleplayconsolemcp) 

蟒蛇 模型上下文协议 服务器 让AI助手（Claude等）管理完整的Google Play商店版本 直接生命周期——从上传工件到管理测试人员、推出、， 以及Android Vitals。

______________________________________________________________________

快速开始

选项A-- uvx （推荐，无需安装）

运行一次。Claude在每次会话中都会自动启动和停止服务器——你永远不必再碰它。

claude mcp add google-play-mcp \
  -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json \
  -- uvx google-play-mcp

需要 uv --安装方式 brew install uv 或 curl -Lsf https://astral.sh/uv/install.sh | sh

选项B-- pip install

如果您更喜欢永久安装：

pip install google-play-mcp

claude mcp add google-play-mcp \
  -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json \
  -- google-play-mcp

选项C-HTTP（本地服务器）

仅当您想通过HTTP传输而不是stdio连接时才需要：

# Terminal 1 — start the server
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json \
  uvx google-play-mcp --transport http --port 8080

# Terminal 2 — register with Claude
claude mcp add --transport http google-play-mcp http://localhost:8080

stdio的工作原理： 使用选项A和B，不需要手动启动服务器。 当会话打开和关闭时，Claude会在后台启动该进程 当会话结束时。零维护。

______________________________________________________________________

特性

曲目与发布

工件管理

测试人员管理

安卓重要信息

______________________________________________________________________

先决条件

1. uv — 安装指南
2. A. 谷歌云服务帐户 下载JSON密钥。
3. 服务帐户已添加到 谷歌游戏控制台 具有正确的权限（见下文）。
4. 您的Google Cloud项目中启用了以下API：

- Google Play Android开发人员API - Google Play开发者报告API

所需的游戏控制台权限

重要提示： 发布经理会 不 授予报告API访问权限。您还必须启用 查看应用程序信息并下载批量报告（只读） --在账户层面和 每个应用程序级别——让Vitals工具正常工作。

______________________________________________________________________

Claude桌面集成

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

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

保存后重新启动Claude Desktop。

______________________________________________________________________

服务帐户设置

1. 首选 IAM和管理员→ 服务账户 在你的GCP项目中。
2. 创建一个服务帐户（或使用现有帐户）并下载JSON密钥。
3. 在 谷歌游戏控制台 → 设置→ API访问:

- 链接您的Google Cloud项目。 - 查找服务帐户→ 管理游戏控制台权限. - 在...之下 帐户权限，启用 查看应用程序信息并下载批量报告（只读）. - 在...之下 应用程序权限 对于每个应用程序，启用： - 查看应用程序信息并下载批量报告（只读） - 投入生产… _（如果您需要写访问权限）_ - 点击 应用 → 邀请用户.

必须在以下时间授予权限 两者 帐户级别和每个应用程序级别。 对于API报告而言，单独的会计级别是不够的。

______________________________________________________________________

工具参考

list_tracks

package_name : str  — e.g. "com.example.myapp"

返回所有曲目及其发布、推出百分比、状态和国家可用性。

______________________________________________________________________

get_track_info

package_name : str
track        : str  — "internal" | "alpha" | "beta" | "production" (default: "production")

返回人类可读的摘要以及带有状态、推出百分比、版本代码和发行说明的版本。

______________________________________________________________________

create_release

package_name       : str
track              : str        — "internal" | "alpha" | "beta" | "production"
version_codes      : list[int]  — e.g. [1042]
rollout_percentage : float      — default 10.0 (used when status is "inProgress")
status             : str        — "draft" (default) | "inProgress" | "halted" | "completed"
release_name       : str        — optional
release_notes      : dict       — optional, e.g. {"en-US": "Bug fixes", "fr-FR": "Corrections"}
country_codes      : list[str]  — optional ISO 3166-1 alpha-2 codes, e.g. ["US", "GB"]

在给定轨迹上创建或替换版本。使用 status="inProgress" 带着一个 rollout_percentage 进行分阶段的生产推广，或 status="completed" 释放 立即发送给所有用户。

______________________________________________________________________

update_release

package_name       : str
track              : str    — default "production"
rollout_percentage : float  — optional; pass 100 to complete the rollout
status             : str    — optional; "inProgress" | "halted" | "completed" | "draft"
version_codes      : list[int]  — optional filter; targets first matching release if omitted

更新现有版本。常见用例：

• 增加推出： update_release(pkg, rollout_percentage=50)
• 完成推出： update_release(pkg, rollout_percentage=100)
• 停止推出： update_release(pkg, status="halted")
• 恢复卷展： update_release(pkg, status="inProgress")

______________________________________________________________________

promote_release

package_name       : str
from_track         : str        — "internal" | "alpha" | "beta"
to_track           : str        — "alpha" | "beta" | "production"
version_codes      : list[int]
rollout_percentage : float      — default 10.0
release_name       : str        — optional override
release_notes      : dict       — optional override; inherits from source if omitted

将版本从一个轨道复制到另一个轨道。发行说明和名称继承自 源代码发布，除非明确重写。

______________________________________________________________________

list_artifacts

package_name : str

返回所有按版本代码（最新版本优先）排序的APK和AAB，并使用SHA哈希值。

______________________________________________________________________

upload_artifact

package_name       : str
file_path          : str    — absolute local path to .apk or .aab
track              : str    — default "internal"
status             : str    — "draft" (default) | "inProgress" | "completed"
rollout_percentage : float  — default 10.0 (used when status is "inProgress")
release_name       : str    — optional
release_notes      : dict   — optional

上传APK或AAB（从扩展中自动检测），并在给定的版本上创建发布 在单个原子操作中跟踪。返回分配的版本代码。

______________________________________________________________________

upload_to_internal_sharing

package_name : str
file_path    : str  — absolute local path to .apk or .aab

将构建上传到内部应用程序共享（绕过曲目分配）并返回 可共享的 downloadUrl。测试人员必须在其游戏中启用内部应用程序共享 存储设置。非常适合快速进行一次性测试，而不会影响任何发布轨迹。

______________________________________________________________________

get_testers

package_name : str
track        : str  — "internal" (default) | "alpha"

返回测试人员电子邮件地址和跟踪的Google组列表。

______________________________________________________________________

update_testers

package_name  : str
track         : str         — "internal" (default) | "alpha"
emails        : list[str]   — optional; full replacement list of tester emails
google_groups : list[str]   — optional; full replacement list of Google Group emails

警告： 这是一个完整的替代品。不在新列表中的测试人员将失去访问权限。 呼叫 get_testers 如果您只想添加/删除个人，请首先检索当前列表。

______________________________________________________________________

get_crash_rate

package_name : str
days         : int  — look-back window, 1–30 (default 7)
version_code : str  — optional single version code to filter

每天返回 crashRate, userPerceivedCrashRate，以及 distinctUsers 每个版本代码。 谷歌对用户感知崩溃率的不良行为阈值是 ~1.09%.

______________________________________________________________________

get_anr_rate

package_name : str
days         : int  — look-back window, 1–30 (default 7)
version_code : str  — optional single version code to filter

每天返回 anrRate, userPerceivedAnrRate，以及 distinctUsers 每个版本代码。 谷歌对用户感知ANR率的不良行为阈值为 ~0.47%.

______________________________________________________________________

get_vitals_summary

package_name : str
days         : int  — look-back window, 1–30 (default 7)

返回按版本代码聚合的组合崩溃+ANR摘要，平均值超过 时期和 exceedsCrashThreshold / exceedsAnrThreshold 旗帜。最新版本 突出显示为 latestVersionSummary.

get_wakelock_rate

package_name : str
days         : int  — look-back window, 1–30 (default 7)
version_code : str  — optional single version code to filter

每天返回 stuckBackgroundWakelockRate 和 distinctUsers 每个版本代码。 与2026年Google Play电池健康执法相关——应用程序过度使用 在后台保持部分唤醒锁定超过1小时的会话比例 可能会受到处罚。

______________________________________________________________________

get_wakeup_rate

package_name : str
days         : int  — look-back window, 1–30 (default 7)
version_code : str  — optional single version code to filter

每天返回 excessiveWakeupRate 和 distinctUsers 每个版本代码。 与2026年Google Play电池健康执法相关——也会唤醒CPU的应用程序 经常（高于平台阈值）可能会受到处罚。

______________________________________________________________________

故障排除

403 Forbidden 关于重要工具

403 Client Error: Forbidden for url: https://playdeveloperreporting.googleapis.com/...

此错误有两个常见原因——请同时检查：

1.未启用Google Play开发者报告API

在您的Google Cloud项目中启用它： console.cloud.google.com/apis/library/playdeveloperreporting.googleapis.com

2.服务帐户缺少每个应用程序报告API的访问权限

1. 游戏控制台→ 设置→ API访问 → 查找服务帐户→ 管理游戏控制台权限.
2. 在...之下 应用程序权限，选择应用程序并启用 查看应用程序信息并下载批量报告（只读）.
3. 保存并等待几分钟，以便更改传播。

404 Package not found

服务帐户必须链接到拥有该应用程序的同一Google Play Console帐户。 转到游戏控制台→ 设置→ API访问 并验证服务帐户是否已列出并已被邀请。

______________________________________________________________________

市场

______________________________________________________________________

许可证

麻省理工学院