播放商店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项目
- 首选 谷歌云控制台
- 创建新项目或选择现有项目
- 启用Google Play Android开发者API：
- 转到“API和服务”→ “图书馆” - 搜索“Google Play Android开发者API” - 点击“启用”
步骤2：创建服务帐户
- 在谷歌云控制台中，转到“IAM和管理”→ “服务帐户”
- 点击“创建服务帐户”
- 填写详细信息：
- 名字: play-store-mcp - 描述: Service account for Play Store MCP operations
- 点击“创建并继续”
- 在“授予此服务帐户对项目的访问权限”中，您不需要分配特定的角色
- 点击“完成”
步骤3：生成服务帐户密钥
- 在服务帐户列表中，找到您刚才创建的帐户
- 点击服务帐户电子邮件
- 转到“密钥”选项卡
- 点击“添加密钥”→ “创建新密钥”
- 选择“JSON”作为密钥类型
- 点击“创建”
- 将下载一个JSON文件-这是您的
service-account-key.json
步骤4：在Google Play控制台中配置权限
- 首选 谷歌游戏控制台
- 选择您的开发人员帐户
- 转到“用户和权限”
- 点击“邀请新用户”
- 添加服务帐户的电子邮件
- 点击“邀请用户”
- 配置必要的权限：
- 应用程序权限：选择它可以管理的应用程序 - 帐户权限：授予“查看应用信息”和“版本”下的权限
发布新功能时可能需要更多权限。
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许可证获得许可-请参阅 许可证 文件以获取详细信息。