gpc-mcp-server

🤖 Google Play Console MCP 服务

这是一个功能强大的 Model Context Protocol (MCP) 服务，可让 AI 助手（如 Claude、Gemini 或任何 MCP 客户端）直接管理您的 Google Play Console。

发布应用时，无需再在缓慢的网页界面中反复点击。只需让您的 AI Agent 来处理。

“Claude，生产环境的崩溃率是多少？” “Gemini，创建一个新的内部测试版本并更新版本说明。” “Claude，列出今天的 1 星评价，并回复用户以询问详情。”

---

🌟 主要功能

• 🚀 版本发布管理： 创建版本、管理测试轨道、更新版本说明，并控制分阶段推出。
• 📊 应用质量与报告： 即时获取用户获取数据、崩溃率和 ANR 统计信息。
• 💬 评价管理： 查看用户评价、按评分筛选，并自动发布回复。
• 🖼️ 商店展示： 更新商店商品信息、翻译内容，并管理截图和功能图片。

🛠️ 提供的工具

此 MCP 服务向您的 AI Agent 提供 65 个工具。重点工具如下：

📦 应用与商品信息

• gpc_get_app_info - 获取应用详情（包名、默认语言、联系信息）
• gpc_list_listings - 获取所有语言区域的商店商品信息
• gpc_update_listing - 更新指定语言区域的商店商品信息

🚀 版本与测试轨道管理

• gpc_list_tracks - 列出测试轨道（内部、alpha、beta、production）及其当前版本
• gpc_create_release - 在指定测试轨道上创建新版本
• gpc_update_release_notes - 更新最新版本的版本说明
• gpc_set_rollout - 设置或更新分阶段推出的百分比
• gpc_halt_rollout - 暂停正在进行的分阶段推出

💬 评价

• gpc_list_reviews - 获取用户评价及其评分和回复状态
• gpc_reply_review - 回复用户评价

📈 报告与质量指标

• gpc_acquisition_report - 获取安装和用户获取统计数据
• gpc_crash_report - 获取 Android Vitals 中的崩溃率和 ANR 率
• gpc_crash_anomaly_detector - 将最近 2 天的崩溃率与此前 12 天的基线进行比较，并标记值得暂停推出的异常飙升（🚨）

📸 截图与图片

• gpc_list_images - 列出指定语言区域已上传的图片
• gpc_upload_image - 上传截图、功能图片或图标
• gpc_upload_images_batch - 在单次编辑中跨多个语言区域上传多张图片（为新语言区域添加初始内容时必须使用：Play 要求提交时至少有 2 张手机截图，因此逐个文件提交会因“截图数量不足”而失败）
• gpc_delete_image - 删除指定图片

---

⚙️ 快速开始

1. 获取服务账号密钥

1. 前往 Google Cloud Console。
2. 启用 “Google Play Android Developer API”。
3. 创建服务账号并下载 JSON 密钥。
4. 在 Google Play Console > 设置 > API 访问权限中：
   • 关联您的 Google Cloud 项目。
   • 向服务账号授予 “管理员” 或 “发布经理” 权限。

2. 安装

克隆此仓库并构建：

git clone https://github.com/YOUR_USERNAME/gpc-mcp-server.git
cd gpc-mcp-server
npm install
npm run build

3. 连接到 Claude Code（或任何 MCP 客户端）

使用 claude mcp add 命令将此服务添加到您的 Claude 环境中：

claude mcp add --scope user gpc-mcp \
  -e GOOGLE_PLAY_SERVICE_ACCOUNT_JSON=/path/to/your/service-account.json \
  -e GOOGLE_PLAY_PACKAGE_NAME=com.yourcompany.appname \
  -- node /path/to/gpc-mcp-server/dist/index.js

所需的环境变量

变量	说明	示例
GOOGLE_PLAY_SERVICE_ACCOUNT_JSON	服务账号 JSON 密钥的绝对路径	/users/me/secrets/play-store.json
GOOGLE_PLAY_PACKAGE_NAME	您的 Android 应用包名	com.example.myapp

🤖 AI 提示词示例

配置完成后，你可以直接自然地与 AI Agent 对话：

检查应用健康状况：

“今天我们的应用有没有新增崩溃？” -> Agent 调用 gpc_crash_report

发布安全检查：

“我们最新的发布是否安全，还是应该暂停？” -> Agent 调用 gpc_crash_anomaly_detector，如果检测到异常峰值，则接着调用 gpc_halt_rollout

发布工作流：

“创建一个新的内部发布，并将土耳其语发布说明更新为‘错误修复’。” -> Agent 调用 gpc_create_release 和 gpc_update_release_notes

客户支持：

“找出本周所有 1 星评价，并为我起草回复。” -> Agent 调用 gpc_list_reviews 和 gpc_reply_review

根据 Git 自动生成发布说明：

“查看自上一个标签以来的提交，根据这些提交撰写用户友好的发布说明，然后发布。” -> Agent 读取你的本地 git 历史记录，起草文案，并调用 gpc_update_release_notes

商店列表优化：

“获取我们当前的商店列表，并建议一条更有吸引力的简短描述，以提高转化率。” -> Agent 调用 gpc_list_listings 读取当前文案，然后调用 gpc_update_listing 发布新文案

---

📝 支持的语言区域

包含标准的 Play Console 语言区域：en-US、tr-TR、de-DE、es-419、fr-FR、ru-RU、ar 等。

📄 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。