Play Store MCP Server

一个启用与Google Play控制台交互以部署和管理Android应用程序的MCP（模型上下文协议）服务器。

⚠️ 开发状态

尽管目前可以正常使用，但此MCP服务器仍在开发中。 请谨慎使用，并首先在非生产环境中彻底测试。

如果您遇到任何问题或有功能请求，请在GitHub上打开一个问题。您的反馈对于改进这个项目非常有价值。

这是什么？

此MCP服务器提供了以下工具：

• 部署新的Android应用程序版本
• 在不同轨道之间推广发布（内部 → Alpha → Beta → 生产）
• 查询现有发布的状态

可用工具

1. deploy_app

部署应用程序的新版本到Play商店。

参数：

• packageName (字符串)：应用包名（例如，com.example.myapp）
• track (字符串)：发布轨道（内部、Alpha、Beta、生产）
• apkPath (字符串)：APK或AAB文件路径
• versionCode (整数)：版本代码（必须高于当前版本）
• releaseNotes (字符串，可选)：发布说明
• rolloutPercentage (数字，可选)：分阶段发布百分比（0.0至1.0，默认：1.0全量发布）

2. promote_release

从一个轨道向另一个轨道推广现有版本。

参数：

• packageName (字符串)：应用包名
• fromTrack (字符串)：源轨道（内部、Alpha、Beta）
• toTrack (字符串)：目标轨道（Alpha、Beta、生产）
• versionCode (整数)：要推广的版本代码

3. get_releases

获取特定包的应用发布和部署的当前状态。

参数：

• packageName (字符串)：应用包名（例如，com.example.myapp）

设置

1. Google Cloud 和 Play 控制台设置

步骤 1：创建 Google Cloud 控制台项目

1. 访问 Google Cloud 控制台
2. 创建一个新的项目或选择现有的项目
3. 启用 Google Play Android 开发者 API：
   • 转到“API和服务”→“库”
   • 搜索“Google Play Android 开发者 API”
   • 点击“启用”

步骤 2：创建服务账户

1. 在 Google Cloud 控制台中，转到“IAM 和管理”→“服务账户”
2. 点击“创建服务账户”
3. 填写详情：
   • 名称：play-store-mcp
   • 描述：用于 Play Store MCP 操作的服务账户
4. 点击“创建并继续”
5. 在“为此服务账户分配项目访问权限”中，无需分配特定角色
6. 点击“完成”

步骤 3：生成服务账户密钥

1. 在服务账户列表中找到您刚刚创建的那个
2. 点击服务账户电子邮件地址
3. 转到“密钥”标签页
4. 点击“添加密钥”→“创建新密钥”
5. 选择“JSON”作为密钥类型
6. 点击“创建”
7. 将下载一个 JSON 文件——这就是您的 service-account-key.json

步骤 4：在 Google Play 控制台中配置权限

1. 访问 Google Play 控制台
2. 选择您的开发者账户
3. 转到“用户和权限”
4. 点击“邀请新用户”
5. 添加服务账户的电子邮件地址
6. 点击“邀请用户”
7. 配置必要的权限：
   • 应用权限：选择它可以管理的应用
   • 账户权限：授予“查看应用信息”以及“版本”下的权限

当新功能发布时可能需要更多权限。

2. MCP 客户端配置

在您的 MCP 配置文件中添加以下配置：

{
  "mcpServers": {
    "play-store-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/play-store-mcp-all.jar"
      ],
      "env": {
        "PLAY_STORE_SERVICE_ACCOUNT_KEY_PATH": "/path/to/service-account-key.json",
        "PLAY_STORE_DEFAULT_TRACK": "internal"
      }
    }
  }
}

环境变量

• PLAY_STORE_SERVICE_ACCOUNT_KEY_PATH：服务账户 JSON 文件的路径（必需）
• PLAY_STORE_DEFAULT_TRACK：部署的默认轨道（可选，默认：“内部”）

构建

要构建项目：

./gradlew clean build -x test

这将在 build/libs/play-store-mcp-all.jar 生成 JAR 文件。

您也可以从最新 发布 下载 jar。

使用

配置完成后，您可以从任何兼容的 MCP 客户端使用这些工具。

一些示例提示如下：

如果您想了解应用的当前发布版本：

告诉我 com.example.myapp 的哪些版本已发布到 Play 商店。

要将应用的新版本发布到 Alpha 轨道，您可以这样说：

升级应用版本，构建 AAB 并上传到 Alpha 轨道。

要进行逐步发布（例如，50% 用户）：

更新应用版本，编译 AAB 并将其发布到 Play 商店的 Alpha 轨道，使用 50% 的逐步发布，使用 @release_notes.txt。

要求

• Java 8 或更高版本
• Google Play 控制台开发者账户
• 启用了 Play 开发者 API 的 Google Cloud 项目
• 已在 Play 控制台发布的应用（至少作为草稿）

限制

• 仅支持 APK 和 AAB 文件
• 需要应用已在 Play 控制台中配置
• 服务账户权限必须在 Play 控制台中手动配置

故障排除

错误："未找到服务账户密钥"

验证 PLAY_STORE_SERVICE_ACCOUNT_KEY_PATH 中的路径是否正确且文件存在。

错误："调用方没有权限"

确保服务账户已在 Google Play 控制台中正确配置并具有必要的权限。

错误："未找到包名"

验证包名是否正确且应用已在 Play 控制台中配置。

许可证

本项目根据 MIT 许可证授权——请参阅 LICENSE 文件以获取详细信息。