AI导哈

应用发布管理协议

一个用于管理华为应用商店应用发布的模型上下文协议服务器，支持查询和更新应用元数据、管理本地化商店列表、上传APK/AAB文件以及提交应用发布等功能。

  • by AgiMaulana
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 AgiMaulana/HuaweiAppGalleryMcp

使用说明

华为应用程序库MCP

A. 模型上下文协议（MCP） 用于管理应用发布的服务器 华为AppGallery Connect。直接与Claude Desktop或任何MCP兼容客户端集成。

特性

  • 查询和更新应用程序元数据（名称、描述、类别、评级、支持联系人）
  • 按语言管理本地化商店列表
  • 上传APK/AAB文件，自动分块上传大文件（>4 GB）
  • 提交应用程序以进行完整发布、分阶段（灰色）发布、计划发布或开放测试(channel_id=2)
  • 当二进制文件托管在您自己的服务器上时提交应用程序
  • 管理分阶段发布生命周期（状态更改、百分比更新）
  • 查询AAB编译状态
  • 更新计划发布时间
  • 设置GMS依赖标志
  • 获取下载/安装并安装故障报告URL

安装

通过MCP注册表（推荐）

克劳德代码：

claude mcp add --from-registry io.github.AgiMaulana/HuaweiAppGalleryMcp

其他MCP客户端： 在以下网址找到它 register.modelcontextprotocol.io --搜索 huawei-appgallery.

手动安装

pip install huawei-app-gallery-mcp

或与 uv:

uv pip install huawei-app-gallery-mcp

配置

1.获取API证书

  1. 首选 AppGallery Connect
  2. 引导到 用户和权限 → API密钥 → 连接API
  3. 点击 创建 并选择 应用程序管理器 角色
  4. 复制 客户端ID 和 客户端密钥

这些是 连接API 凭证——不同于HMS Core应用程序凭证。

2.设置环境变量

创建一个 .env 工作目录中的文件（服务器会自动加载）：

HUAWEI_CLIENT_ID=your_connect_api_client_id
HUAWEI_CLIENT_SECRET=your_connect_api_client_secret

# Optional: set a default app ID so you don't have to pass it to every tool call
HUAWEI_APP_ID=your_app_id

3.连接到您的MCP客户端（仅限手动安装）

克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "huawei-appgallery": {
      "command": "huawei-app-gallery-mcp",
      "env": {
        "HUAWEI_CLIENT_ID": "your_client_id",
        "HUAWEI_CLIENT_SECRET": "your_client_secret",
        "HUAWEI_APP_ID": "your_app_id"
      }
    }
  }
}

Claude Code（机器级，仅手动安装）

创建 /Library/Application Support/ClaudeCode/managed-mcp.json （macOS）或 /etc/claude-code/managed-mcp.json （Linux）：

{
  "mcpServers": {
    "huawei-appgallery": {
      "type": "stdio",
      "command": "huawei-app-gallery-mcp",
      "env": {
        "HUAWEI_CLIENT_ID": "your_client_id",
        "HUAWEI_CLIENT_SECRET": "your_client_secret",
        "HUAWEI_APP_ID": "your_app_id"
      }
    }
  }
}

工具

所有工具都接受可选 app_id 争论。如果省略， HUAWEI_APP_ID 默认情况下，使用环境中的。

工具 说明
query_app_info 查询当前应用程序元数据（名称、描述、类别、评级等），可选择通过以下方式查询特定发布渠道 channel_id
update_app_info 更新AppGallery Connect草稿中的应用元数据
update_language_info 添加或更新特定语言的本地化商店列表
delete_language_info 删除本地化商店列表
get_upload_url 在上传文件之前，获取预先签名的上传URL和身份验证码
upload_app_file 从本地磁盘上传APK/AAB并将其附加到应用程序草稿（自动分块大于4 GB）
update_app_file_info 手动将已上传的文件附加到应用程序草稿中
query_compile_status 查询一个或多个包ID的AAB编译状态
submit_app 提交应用程序以供审查和发布（支持通过以下方式进行全面、分阶段、计划和开放测试 channel_id=2)
submit_app_with_file 当二进制文件托管在您自己的服务器上时提交
change_phased_release_state 更改分阶段发布状态：继续、回滚或停止
update_phased_release 将分阶段发布转换为完整发布或更新推出时间表/百分比
update_release_time 更新计划发布时间（仅当应用程序处于发布状态时）
set_gms_dependency 报告应用程序是否依赖于GMS
get_download_report_url 获取应用程序下载和安装报告的下载URL（CSV/Excel，最多180天）
get_install_failure_report_url 获取安装失败报告的下载URL（CSV/Excel，最多180天）

用法示例

上传并发布新版本：

上传 /path/to/app-release.aab （AAB，文件类型5）然后提交完整版本。

分阶段推出：

将应用程序提交给20%的用户分阶段发布。

开放式测试：

提交应用程序进行开放测试（channel_id=2）。

检查开放测试：

使用查询打开的测试通道的应用元数据 query_app_info(channel_id=2).

更新发行说明：

将英文发行说明更新为“Bug修复和性能改进”。

计划发布：

提交应用程序，以便在2026年3月20日10:00 UTC发布。

下载报告：

以英文CSV格式获取过去30天的下载和安装报告URL。

发布工作流

Update app info  →  Update language info  →  Upload APK/AAB  →  Submit app
  1. 使用 update_app_info / update_language_info 设置元数据和发行说明
  2. 使用 upload_app_file 上传二进制文件（自动处理分块）
  3. 使用 submit_app 触发审查和发布

软件包发布工作流

有关软件包发布说明，请参阅 docs/RELEASE.md.

API 参考

此服务器包装 AppGallery连接发布API.

许可证

麻省理工学院

相关 MCP