HuaweiAppGalleryMcp 是一个 Model Context Protocol（MCP）服务器，用于在华为应用市场 AppGallery Connect 上管理应用发布。它可直接集成 Claude Desktop 或任何兼容 MCP 的客户端。
主要能力
- 查询和更新应用元数据：名称、描述、分类、评分、支持联系方式。
- 管理分语言的本地化商店信息。
- 上传 APK / AAB 文件，大文件（超过 4 GB）自动分块上传。
- 提交应用进行以下发布方式：完整发布、分阶段（灰度）发布、定时发布、开放式测试（channel_id=2）。
- 当二进制文件托管在自有服务器时提交应用。
- 管理分阶段发布生命周期（状态变更、百分比更新）。
- 查询 AAB 编译状态。
- 更新定时发布时间。
- 设置 GMS 依赖标志。
- 获取下载/安装和安装失败报告 URL。
安装方式
通过 MCP Registry（推荐）
其他 MCP 客户端：可在 registry.modelcontextprotocol.io 搜索 huawei-appgallery 找到。
手动安装
- 获取 API 凭据：
- 前往 AppGallery Connect。
- 导航到 Users & Permissions → API key → Connect API。
- 点击 Create 并选择 App manager 角色。
- 复制 Client ID 和 Client Secret。
- 这些是 Connect API 凭据，不同于 HMS Core 应用凭据。
- 设置环境变量： 在工作目录中创建 .env 文件（服务器会自动加载）。
- 连接 MCP 客户端（仅手动安装时）：
- macOS：添加到 ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：添加到 %APPDATA%\Claude\claude_desktop_config.json
- 或创建 /Library/Application Support/ClaudeCode/managed-mcp.json（macOS）或 /etc/claude-code/managed-mcp.json（Linux）
所有工具都接受可选的 app_id 参数。如果省略，则使用环境变量中的 HUAWEI_APP_ID 作为默认值。
使用方式示例
- 上传并发布新版本：上传 /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 天英文 CSV 格式的下载和安装报告 URL。
发布工作流
- 使用 update_app_info / update_language_info 设置元数据和发布说明。
- 使用 upload_app_file 上传二进制文件（自动处理分块）。
- 使用 submit_app 触发审核并发布。
打包发布工作流
关于打包发布说明，请参阅 docs/RELEASE.md。
该服务器封装了 AppGallery Connect Publishing API。
