Huawei AppGallery MCP

Сервер Model Context Protocol (MCP) для управления публикацией приложений в Huawei AppGallery Connect. Интегрируется напрямую с Claude Desktop или любым клиентом, поддерживающим MCP.

Функции

• Запрос и обновление метаданных приложения (название, описание, категория, рейтинги, контактные данные поддержки)

• Управление локализованными описаниями в магазине для каждого языка

• Загрузка файлов APK / AAB с автоматической фрагментированной загрузкой для больших файлов (>4 ГБ)

• Отправка приложений на полный релиз, поэтапный (серый) релиз, запланированный релиз или открытое тестирование (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. Перейдите в Users & Permissions (Пользователи и разрешения) → API key (Ключ API) → 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 из переменных окружения.

Примеры использования

Загрузка и выпуск новой версии:

Загрузите /path/to/app-release.aab (AAB, тип файла 5), затем отправьте его на полный релиз.

Поэтапное развертывание:

Отправьте приложение на поэтапный релиз для 20% пользователей.

Открытое тестирование:

Отправьте приложение на открытое тестирование (channel_id=2).

Проверка открытого тестирования:

Запросите метаданные приложения для канала открытого тестирования с помощью query_app_info(channel_id=2).

Обновление примечаний к выпуску:

Обновите примечания к выпуску на английском языке на "Исправление ошибок и повышение производительности".

Запланированный релиз:

Отправьте приложение на релиз 20 марта 2026 года в 10:00 UTC.

Скачивание отчета:

Получите URL отчета о скачиваниях и установках за последние 30 дней в формате 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