AI导哈

Android应用部署服务器

一个用于与Google Play Console交互以部署和管理Android应用程序的MCP服务器。

  • by antoniolg
  • Kotlin
  • 本地部署
  • 167 星标
  • 更新于
在 GitHub 查看 devexpert-io/play-store-mcp

使用说明

播放商店MCP服务器

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

⚠️ 开发状态

虽然它目前正在运行，但这个MCP服务器正在开发中。 请谨慎使用，并首先在非生产环境中进行彻底测试。

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

这是什么？

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

  • 部署新版本的Android应用程序
  • 促进轨道之间的发布（内部→ 阿尔法→ beta → 生产）
  • 查询现有版本的状态

可用工具

1. deploy_app

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

参数：

  • packageName （string）：应用程序包名称（例如com.example.myapp）
  • track （字符串）：发布轨迹（内部、alpha、beta、生产）
  • apkPath （string）：APK或AAB文件的路径
  • versionCode （整数）：版本代码（必须高于当前版本）
  • releaseNotes （字符串，可选）：发行说明
  • rolloutPercentage （数字，可选）：展开百分比（0.0到1.0，默认值：1.0表示完全展开）

2. promote_release

将现有版本从一个轨道升级到另一个轨道。

参数：

  • packageName （string）：应用程序包名称
  • fromTrack （字符串）：源曲目（内部、阿尔法、贝塔）
  • toTrack （string）：目标轨道（alpha、beta、生产）
  • versionCode （整数）：要升级的版本代码

3. get_releases

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

参数：

  • packageName （string）：应用程序包名称（例如com.example.myapp）

设置

1.Google Cloud和Play控制台设置

第一步：创建Google Cloud Console项目

  1. 首选 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 启用Google Play Android开发者API：
    • 转到“API和服务”→ “图书馆”
    • 搜索“Google Play Android开发者API”
    • 点击“启用”

步骤2：创建服务帐户

  1. 在谷歌云控制台中，转到“IAM和管理”→ “服务帐户”
  2. 点击“创建服务帐户”
  3. 填写详细信息：
    • 名字: play-store-mcp
    • 描述: Service account for Play Store MCP operations
  4. 点击“创建并继续”
  5. 在“授予此服务帐户对项目的访问权限”中，您不需要分配特定的角色
  6. 点击“完成”

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

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

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

  1. 首选 谷歌游戏控制台
  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

这将在以下位置生成JAR文件 build/libs/play-store-mcp-all.jar.

您还可以下载 jar 从最新 发布.

用法

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

一些提示示例如下：

如果你想获取该应用程序的最新版本：

请告诉我Play商店中发布了哪些版本的com.example.myapp。

要将新版本的应用程序发布到alpha频道，您可以说：

升级应用程序的版本，构建AAB，并将其上传到alpha频道。

要逐步部署（例如，50%的用户）：

更新应用程序版本，编译AAB，并使用@release_notes.txt在alpha频道上将其发布到Play商店，并进行50%的推广。

需求

  • Java 8或更高版本
  • Google Play Console开发者帐户
  • 启用Play Developer API的Google Cloud项目
  • 已在Play Console中发布的应用程序（至少是草稿）

局限性

  • 仅支持APK和AAB文件
  • 要求应用程序已在Play Console中配置
  • 必须在Play Console中手动配置服务帐户权限

故障排除

错误：“找不到服务帐户密钥”

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

错误：“调用者没有权限”

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

错误：“找不到包名”

验证包名称是否正确，以及应用程序是否在Play Console中配置。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP