HuaweiAppGalleryMcp

Huawei AppGallery MCP

Un servidor Model Context Protocol (MCP) para gestionar la publicación de aplicaciones en Huawei AppGallery Connect. Se integra directamente con Claude Desktop o cualquier cliente compatible con MCP.

Características

• Consultar y actualizar metadatos de la aplicación (nombre, descripción, categoría, calificaciones, contactos de soporte)
• Gestionar listados de tienda localizados por idioma
• Subir archivos APK / AAB con carga fragmentada automática para archivos grandes (>4 GB)
• Enviar aplicaciones para lanzamiento completo, lanzamiento gradual (gris), lanzamiento programado o pruebas abiertas (channel_id=2)
• Enviar aplicaciones cuando el binario está alojado en tu propio servidor
• Gestionar el ciclo de vida del lanzamiento gradual (cambios de estado, actualizaciones de porcentaje)
• Consultar el estado de compilación de AAB
• Actualizar la hora de lanzamiento programado
• Establecer el indicador de dependencia de GMS
• Obtener URLs de informes de descarga/instalación y de fallos de instalación

Instalación

Mediante el Registro MCP (recomendado)

Claude Code:

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

Otros clientes MCP: Encuéntralo en registry.modelcontextprotocol.io — busca huawei-appgallery.

Instalación manual

pip install huawei-app-gallery-mcp

O con uv:

uv pip install huawei-app-gallery-mcp

Configuración

1. Obtener credenciales de API

1. Ve a AppGallery Connect
2. Navega a Usuarios y permisos → Clave de API → Conectar API
3. Haz clic en Crear y selecciona el rol App manager
4. Copia el Client ID y el Client Secret

Estas son credenciales de Connect API — diferentes de las credenciales de la aplicación HMS Core.

2. Establecer variables de entorno

Crea un archivo .env en tu directorio de trabajo (el servidor lo carga automáticamente):

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. Conéctate a tu cliente MCP (solo instalación manual)

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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 (a nivel de máquina, solo instalación manual)

Crea /Library/Application Support/ClaudeCode/managed-mcp.json (macOS) o /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"
      }
    }
  }
}

Herramientas

Todas las herramientas aceptan un argumento opcional app_id. Si se omite, se usa HUAWEI_APP_ID del entorno como valor predeterminado.

Herramienta	Descripción
query_app_info	Consultar metadatos actuales de la aplicación (nombre, descripción, categoría, calificaciones, etc.), opcionalmente para un canal de lanzamiento específico mediante channel_id
update_app_info	Actualizar metadatos de la aplicación en el borrador de AppGallery Connect
update_language_info	Añadir o actualizar un listado de tienda localizado para un idioma específico
delete_language_info	Eliminar un listado de tienda localizado
get_upload_url	Obtener una URL de carga pre-firmada y un código de autenticación antes de subir un archivo
upload_app_file	Subir un APK/AAB desde el disco local y adjuntarlo al borrador de la aplicación (fragmentación automática para >4 GB)
update_app_file_info	Adjuntar manualmente archivos ya subidos al borrador de la aplicación
query_compile_status	Consultar el estado de compilación de AAB para uno o más ID de paquete
submit_app	Enviar la aplicación para revisión y lanzamiento (admite lanzamiento completo, gradual, programado y pruebas abiertas mediante channel_id=2)
submit_app_with_file	Enviar cuando el binario está alojado en tu propio servidor
change_phased_release_state	Cambiar el estado del lanzamiento gradual: continuar, revertir o detener
update_phased_release	Convertir el lanzamiento gradual en lanzamiento completo o actualizar el cronograma/porcentaje de implementación
update_release_time	Actualizar la hora de lanzamiento programado (solo cuando la aplicación está en estado Releasing)
set_gms_dependency	Informar si la aplicación depende de GMS
get_download_report_url	Obtener URL de descarga para el informe de descarga e instalación de la aplicación (CSV/Excel, máx. 180 días)
get_install_failure_report_url	Obtener URL de descarga para el informe de fallos de instalación (CSV/Excel, máx. 180 días)

Ejemplos de uso

Subir y lanzar una nueva versión:

Sube /path/to/app-release.aab (AAB, tipo de archivo 5) y luego envíalo para un lanzamiento completo.

Lanzamiento gradual:

Envía la aplicación para un lanzamiento gradual al 20% de los usuarios.

Pruebas abiertas:

Envía la aplicación para pruebas abiertas (channel_id=2).

Inspeccionar pruebas abiertas:

Consulta los metadatos de la aplicación para el canal de pruebas abiertas con query_app_info(channel_id=2).

Actualizar notas de la versión:

Actualiza las notas de la versión en inglés a "Correcciones de errores y mejoras de rendimiento".

Lanzamiento programado:

Envía la aplicación para su lanzamiento el 20 de marzo de 2026 a las 10:00 UTC.

Descargar informe:

Obtén la URL del informe de descarga e instalación de los últimos 30 días en formato CSV en inglés.

Flujo de trabajo de publicación

Update app info  →  Update language info  →  Upload APK/AAB  →  Submit app

1. Usa update_app_info / update_language_info para establecer metadatos y notas de la versión
2. Usa upload_app_file para subir el binario (maneja la fragmentación automáticamente)
3. Usa submit_app para activar la revisión y el lanzamiento

Flujo de trabajo de lanzamiento de paquetes

Para instrucciones de lanzamiento de paquetes, consulta docs/RELEASE.md.

Referencia de API

Este servidor envuelve la API de publicación de AppGallery Connect.

Licencia

MIT