使用说明
mcp安卓应用商店部署
MCP服务器帮助Play商店部署
👉 想在Claude Desktop上使用这个吗?请参阅 完整的克劳德使用指南→
🚀 入门指南
这个工具新手?从这里开始!
打开Claude Desktop并使用以下提示:
I want to set up automated Google Play Store deployment for my Android app using GitHub Actions.
My Android project is located at: /path/to/your/android/app
Please walk me through the complete setup process step by step. Start by analyzing my project.
克劳德将指导您完成:
- ✅ 分析您的项目结构
- ✅ 生成安全密钥库
- ✅ 设置Google Play服务帐户
- ✅ 创建GitHub操作工作流
- ✅ 配置机密和测试
📖 详细指导,请参阅 完整的克劳德使用指南.
注: 以下内容由MCP Generator于2025-11-20 21:40生成。 您可以根据需要编辑、移动或删除此部分。
hitoshura25-mcp安卓应用商店部署
MCP服务器,帮助开发人员为Android应用程序设置自动Google Play商店部署
快速链接
- 📖 Claude桌面用户指南 -使用此MCP服务器与Claude Desktop的完整指南
- 🔧 MCP配置 -技术MCP设置详细信息
- 🔒 安全指南 -安全最佳实践
安装
MCP服务器使用(推荐)
使用uvx(无需安装):
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"hitoshura25_mcp_android_playstore_deploy": {
"command": "uvx",
"args": ["hitoshura25-mcp-android-playstore-deploy"]
}
}
}
先决条件: 安装 紫外线:
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
用于CLI使用(替代)
使用pipx(独立安装):
pipx install hitoshura25-mcp-android-playstore-deploy
使用pip:
pip install hitoshura25-mcp-android-playstore-deploy
用法
MCP服务器模式(适用于AI代理)
如果使用pipx/pip安装,请配置:
{
"mcpServers": {
"hitoshura25_mcp_android_playstore_deploy": {
"command": "hitoshura25-mcp-android-playstore-deploy"
}
}
}
CLI模式(适用于开发人员)
分析型雄激素项目
分析Android项目以了解其配置并确定Play商店部署的要求
hitoshura25-mcp-android-playstore-deploy analyze_android_project --project_path <value>
参数:
--project_path(string,必填):Android项目根目录的绝对路径
generate_keystore
生成一个新的Android密钥库文件,用于使用安全参数进行应用签名
hitoshura25-mcp-android-playstore-deploy generate_keystore --output_path <value> --alias <value> --key_password <value> --store_password <value> --validity_days <value> --key_size <value> --dname <value>
参数:
-
--output_path(string,必填):保存密钥库的绝对路径 -
--alias(string,必填):签名密钥的密钥别名 -
--key_password(string,必填):签名密钥的密码 -
--store_password(字符串,必填):密钥库的密码 -
--validity_days(数字):密钥应有效多少天 -
--key_size(number):密钥大小(位) -
--dname(string):证书的可分辨名称
generate_nigning_config
生成Gradle签名配置代码以添加到build.Gradle.kts中
hitoshura25-mcp-android-playstore-deploy generate_signing_config --project_path <value> --signing_strategy <value>
参数:
-
--project_path(string,必填):Android项目的路径 -
--signing_strategy(string):如何提供签名凭据(environment_variables或gradle_properties)
安装服务计数指南
提供设置Google Play服务帐户的交互式分步指南
hitoshura25-mcp-android-playstore-deploy setup_service_account_guide
参数:
generate_github_workflow
为Play商店部署生成完整的GitHub Actions工作流文件
hitoshura25-mcp-android-playstore-deploy generate_github_workflow --project_path <value> --package_name <value> --track <value> --trigger_strategy <value> --branch_name <value> --app_module_path <value> --java_version <value> --enforce_proguard <value> --mapping_file_path <value> --include_release_notes <value> --release_notes_directory <value>
参数:
-
--project_path(string,必填):Android项目的路径 -
--package_name(字符串,必填):Android应用程序包名称 -
--track(字符串):Play商店发布轨迹(内部、alpha、beta、生产) -
--trigger_strategy(string):如何触发工作流(手动、分支、标签) -
--branch_name(string):如果trigger_strategy是分支,则触发的分支名称 -
--app_module_path(string):相对于项目根的应用程序模块的路径 -
--java_version(string):用于构建的Java/JDK版本 -
--enforce_proguard(boolean):自动启用ProGuard缩小(默认值:True) -
--mapping_file_path(string):覆盖默认的ProGuard映射文件路径 -
--include_release_notes(布尔值):包括发行说明目录(默认值:True) -
--release_notes_directory(string):发布说明目录的路径(默认:distribution/whatsnew)
validate_github脚本
验证是否配置了所需的GitHub Secrets(仅检查是否存在)
hitoshura25-mcp-android-playstore-deploy validate_github_secrets --repo_owner <value> --repo_name <value> --github_token <value> --required_secrets <value>
参数:
-
--repo_owner(string,必填):GitHub存储库所有者用户名或组织 -
--repo_name(string,必填):GitHub存储库名称 -
--github_token(string,必填):具有repo范围的GitHub个人访问令牌 -
--required_secrets(array):要检查的秘密名称列表
create_github_secrets_guide
为创建所有必需的GitHub Secrets生成一份全面的指南
hitoshura25-mcp-android-playstore-deploy create_github_secrets_guide --repo_url <value> --keystore_path <value>
参数:
-
--repo_url(字符串,必填):GitHub存储库URL -
--keystore_path(string):编码指令的密钥库的可选路径
validate_play_store_setup
使用服务帐户验证Play Store应用程序和API访问是否已正确配置
hitoshura25-mcp-android-playstore-deploy validate_play_store_setup --service_account_json_path <value> --package_name <value>
参数:
-
--service_account_json_path(string,必填):服务帐户JSON文件的路径 -
--package_name(string,必填):要验证的Android应用程序包名称
测试_部署_工作流
在本地测试部署工作流,无需上传到Play商店
hitoshura25-mcp-android-playstore-deploy test_deployment_workflow --project_path <value> --keystore_path <value> --store_password <value> --key_alias <value> --key_password <value> --dry_run <value>
参数:
-
--project_path(string,必填):Android项目的路径 -
--keystore_path(字符串,必填):密钥库文件的路径 -
--store_password(字符串,必填):密钥库密码 -
--key_alias(字符串,必填):密钥别名 -
--key_password(字符串,必填):密钥密码 -
--dry_run(boolean):如果为true,跳过实际的Play商店上传
可用工具
分析型雄激素项目
分析Android项目以了解其配置并确定Play商店部署的要求
参数:
project_path(string,必填):Android项目根目录的绝对路径
generate_keystore
生成一个新的Android密钥库文件,用于使用安全参数进行应用签名
参数:
-
output_path(string,必填):保存密钥库的绝对路径 -
alias(string,必填):签名密钥的密钥别名 -
key_password(string,必填):签名密钥的密码 -
store_password(字符串,必填):密钥库的密码 -
validity_days(数字):密钥应有效多少天 -
key_size(number):密钥大小(位) -
dname(string):证书的可分辨名称
generate_nigning_config
生成Gradle签名配置代码以添加到build.Gradle.kts中
参数:
-
project_path(string,必填):Android项目的路径 -
signing_strategy(string):如何提供签名凭据(environment_variables或gradle_properties)
安装服务计数指南
提供设置Google Play服务帐户的交互式分步指南
参数:
generate_github_workflow
为Play商店部署生成完整的GitHub Actions工作流文件
参数:
-
project_path(string,必填):Android项目的路径 -
package_name(字符串,必填):Android应用程序包名称 -
track(字符串):Play商店发布轨迹(内部、alpha、beta、生产) -
trigger_strategy(string):如何触发工作流(手动、分支、标签) -
branch_name(string):如果trigger_strategy是分支,则触发的分支名称 -
app_module_path(string):相对于项目根的应用程序模块的路径 -
java_version(string):用于构建的Java/JDK版本 -
enforce_proguard(boolean):如果为True,请确保build.gradle.kts中的isMinifyEnabled=True(默认值:True) -
mapping_file_path(string):覆盖默认的ProGuard映射文件路径 -
include_release_notes(布尔值):包括发行说明目录(默认值:True) -
release_notes_directory(string):发布说明目录的路径(默认:distribution/whatsnew)
validate_github脚本
验证是否配置了所需的GitHub Secrets(仅检查是否存在)
参数:
-
repo_owner(string,必填):GitHub存储库所有者用户名或组织 -
repo_name(string,必填):GitHub存储库名称 -
github_token(string,必填):具有repo范围的GitHub个人访问令牌 -
required_secrets(array):要检查的秘密名称列表
create_github_secrets_guide
为创建所有必需的GitHub Secrets生成一份全面的指南
参数:
-
repo_url(字符串,必填):GitHub存储库URL -
keystore_path(string):编码指令的密钥库的可选路径
validate_play_store_setup
使用服务帐户验证Play Store应用程序和API访问是否已正确配置
参数:
-
service_account_json_path(string,必填):服务帐户JSON文件的路径 -
package_name(string,必填):要验证的Android应用程序包名称
测试_部署_工作流
在本地测试部署工作流,无需上传到Play商店
参数:
-
project_path(string,必填):Android项目的路径 -
keystore_path(字符串,必填):密钥库文件的路径 -
store_password(字符串,必填):密钥库密码 -
key_alias(字符串,必填):密钥别名 -
key_password(字符串,必填):密钥密码 -
dry_run(boolean):如果为true,跳过实际的Play商店上传
发展
# Clone the repository
git clone <your-repo-url>
cd hitoshura25-mcp-android-playstore-deploy
# Install dependencies (including dev dependencies)
pip install -e .[dev]
# Run tests
pytest
需求
- Python≥3.10(MCP SDK需要)
- MCP SDK(模型上下文协议)
发布到PyPI
该项目包括一个用于自动发布PyPI的GitHub Actions工作流。
设置
-
配置PyPI受信任的发布服务器:
- 首选https://pypi.org/manage/account/publishing/
- 将您的GitHub存储库添加为受信任的发布者
- 工作流名称:
pypi-publish.yml
-
创建发布:
# Install pypi-workflow-generator pip install pypi-workflow-generator # Create and push a release tag pypi-release patch # or: minor, major -
GitHub Actions工作流将自动:
- 运行测试
- 构建包
- 发布到PyPI
许可证
阿帕奇-2.0
作者
维纳亚克·梅农
