Android应用商店部署工具

一个帮助开发者设置自动化Google Play商店部署流程的工具,支持项目分析、密钥生成、服务账户配置和GitHub Actions工作流生成。

  • by hitoshura25
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hitoshura25/mcp-android-playstore-deploy

使用说明

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商店部署

快速链接

安装

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工作流。

设置

  1. 配置PyPI受信任的发布服务器:

    • 首选https://pypi.org/manage/account/publishing/
    • 将您的GitHub存储库添加为受信任的发布者
    • 工作流名称: pypi-publish.yml
  2. 创建发布:

    # Install pypi-workflow-generator
    pip install pypi-workflow-generator
    
    # Create and push a release tag
    pypi-release patch  # or: minor, major
    
  3. GitHub Actions工作流将自动:

    • 运行测试
    • 构建包
    • 发布到PyPI

许可证

阿帕奇-2.0

作者

维纳亚克·梅农