Huawei AppGallery MCP

Un servidor de Protocolo de Contexto de Modelo (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, valoraciones, 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 (fase), lanzamiento programado o pruebas abiertas (channel_id=2)

• Enviar aplicaciones cuando el binario está alojado en su 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 la bandera de dependencia de GMS

• Obtener URLs de informes de descarga/instalación y fallos de instalación

Instalación

A través del registro MCP (recomendado)

Claude Code:

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

Otros clientes MCP: Encuéntrelo en registry.modelcontextprotocol.io — busque 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. Vaya a AppGallery Connect

2. Navegue a Usuarios y permisos → Clave API → Connect API

3. Haga clic en Crear y seleccione el rol Gestor de aplicaciones

4. Copie el ID de cliente y el Secreto de cliente

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

2. Establecer variables de entorno

Cree un archivo .env en su 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. Conectar a su cliente MCP (solo instalación manual)

Claude Desktop

Añada 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)

Cree /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 utiliza HUAWEI_APP_ID del entorno como valor predeterminado.

Ejemplos de uso

Subir y lanzar una nueva versión:

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

Despliegue gradual:

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

Pruebas abiertas:

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

Inspeccionar pruebas abiertas:

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

Actualizar notas de lanzamiento:

Actualice las notas de lanzamiento en inglés a "Corrección de errores y mejoras de rendimiento".

Lanzamiento programado:

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

Descargar informe:

Obtenga 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. Use update_app_info / update_language_info para establecer metadatos y notas de lanzamiento

2. Use upload_app_file para subir el binario (gestiona la fragmentación automáticamente)

3. Use submit_app para activar la revisión y el lanzamiento

Flujo de trabajo de lanzamiento de paquetes

Para obtener instrucciones sobre el lanzamiento de paquetes, consulte docs/RELEASE.md.

Referencia de API

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

Licencia

MIT