华为应用市场 MCP

一个用于管理 华为应用市场 (AppGallery Connect) 应用发布流程的 模型上下文协议 (MCP) 服务器。可直接集成到 Claude Desktop 或任何兼容 MCP 的客户端中。

功能特性

• 查询并更新应用元数据（名称、描述、分类、评分、支持联系方式）

• 管理各语言的本地化商店详情

• 上传 APK / AAB 文件，支持大文件（>4 GB）自动分块上传

• 提交应用进行全量发布、分阶段（灰度）发布、定时发布或开放测试（channel_id=2）

• 当二进制文件托管在您自己的服务器上时提交应用

• 管理分阶段发布生命周期（状态变更、百分比更新）

• 查询 AAB 编译状态

• 更新定时发布时间

• 设置 GMS 依赖标志

• 获取下载/安装及安装失败报告的 URL

安装

通过 MCP 注册表（推荐）

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. 导航至 用户与访问 → API 密钥 → Connect API

3. 点击 创建 并选择 应用管理 (App manager) 角色

4. 复制 客户端 ID (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。

使用示例

上传并发布新版本：

上传 /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 APK/AAB  →  Submit app

1. 使用 update_app_info / update_language_info 设置元数据和发布说明

2. 使用 upload_app_file 上传二进制文件（自动处理分块）

3. 使用 submit_app 触发审核和发布

包发布工作流

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

API 参考

此服务器封装了 AppGallery Connect 发布 API。

许可证

MIT