HuaweiAppGalleryMcp

Huawei AppGallery MCP

一个用于管理 Huawei AppGallery Connect 应用发布的 Model Context Protocol (MCP) 服务。可直接与 Claude Desktop 或任何兼容 MCP 的客户端集成。

功能

• 查询和更新应用元数据（名称、描述、类别、评分、支持联系信息）
• 管理各语言的本地化商店页面信息
• 上传 APK / AAB 文件，并自动对大文件（>4 GB）进行分块上传
• 提交应用以进行完整发布、分阶段（灰度）发布、定时发布或开放测试（channel_id=2）
• 在二进制文件托管于您自己的服务上时提交应用
• 管理分阶段发布生命周期（状态变更、百分比更新）
• 查询 AAB 编译状态
• 更新定时发布时间
• 设置 GMS 依赖标志
• 获取下载/安装和安装失败报告 URL

安装

通过 MCP Registry（推荐）

Claude Code：

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

其他 MCP 客户端： 前往 registry.modelcontextprotocol.io 搜索 huawei-appgallery。

手动安装

pip install huawei-app-gallery-mcp

或使用 uv：

uv pip install huawei-app-gallery-mcp

配置

1. 获取 API 凭据

1. 前往 AppGallery Connect
2. 导航至 Users & Permissions → API key → Connect API
3. 点击 Create 并选择 App manager 角色
4. 复制 Client ID 和 Client Secret

这些是 Connect 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 客户端（仅限手动安装）

Claude Desktop

添加到 ~/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	更新定时发布时间（仅当应用处于 Releasing 状态时）
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 fixes and performance improvements”。

定时发布：

提交应用，定于 2026 年 3 月 20 日 10:00 UTC 发布。

下载报告：

获取最近 30 天的下载和安装报告 URL，格式为英文 CSV。

发布工作流

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 Connect Publishing API。

许可证

MIT