Huawei AppGallery MCP

Ein Model Context Protocol (MCP) Server zur Verwaltung der App-Veröffentlichung in Huawei AppGallery Connect. Lässt sich direkt in Claude Desktop oder jeden MCP-kompatiblen Client integrieren.

Funktionen

• Abfrage und Aktualisierung von App-Metadaten (Name, Beschreibung, Kategorie, Bewertungen, Support-Kontakte)

• Verwaltung lokalisierter Store-Einträge pro Sprache

• Hochladen von APK-/AAB-Dateien mit automatischem Chunked-Upload für große Dateien (>4 GB)

• Einreichen von Apps für vollständige Veröffentlichung, phasenweise (Grey) Veröffentlichung, geplante Veröffentlichung oder offene Tests (channel_id=2)

• Einreichen von Apps, wenn die Binärdatei auf Ihrem eigenen Server gehostet wird

• Verwaltung des Lebenszyklus phasenweiser Veröffentlichungen (Statusänderungen, Prozentaktualisierungen)

• Abfrage des AAB-Kompilierungsstatus

• Aktualisierung der geplanten Veröffentlichungszeit

• Festlegen des GMS-Abhängigkeits-Flags

• Abrufen von Download-/Installations- und Installationsfehler-Berichts-URLs

Installation

Über die MCP-Registry (empfohlen)

Claude Code:

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

Andere MCP-Clients: Sie finden ihn unter registry.modelcontextprotocol.io — suchen Sie nach huawei-appgallery.

Manuelle Installation

pip install huawei-app-gallery-mcp

Oder mit uv:

uv pip install huawei-app-gallery-mcp

Konfiguration

1. API-Anmeldedaten abrufen

1. Gehen Sie zu AppGallery Connect

2. Navigieren Sie zu Benutzer & Berechtigungen → API-Schlüssel → Connect API

3. Klicken Sie auf Erstellen und wählen Sie die Rolle App-Manager

4. Kopieren Sie die Client-ID und das Client-Secret

Dies sind Connect API-Anmeldedaten — sie unterscheiden sich von den HMS Core App-Anmeldedaten.

2. Umgebungsvariablen festlegen

Erstellen Sie eine .env-Datei in Ihrem Arbeitsverzeichnis (der Server lädt diese automatisch):

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. Verbindung mit Ihrem MCP-Client herstellen (nur bei manueller Installation)

Claude Desktop

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %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 (auf Maschinenebene, nur bei manueller Installation)

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

Tools

Alle Tools akzeptieren ein optionales app_id-Argument. Wenn es weggelassen wird, wird HUAWEI_APP_ID aus der Umgebung als Standard verwendet.

Nutzungsbeispiele

Neue Version hochladen und veröffentlichen:

Laden Sie /path/to/app-release.aab (AAB, Dateityp 5) hoch und reichen Sie sie dann für eine vollständige Veröffentlichung ein.

Phasenweiser Rollout:

Reichen Sie die App für eine phasenweise Veröffentlichung an 20 % der Benutzer ein.

Offene Tests:

Reichen Sie die App für offene Tests ein (channel_id=2).

Offene Tests überprüfen:

Fragen Sie die App-Metadaten für den Kanal für offene Tests mit query_app_info(channel_id=2) ab.

Versionshinweise aktualisieren:

Aktualisieren Sie die englischen Versionshinweise auf „Fehlerbehebungen und Leistungsverbesserungen“.

Geplante Veröffentlichung:

Reichen Sie die App für eine Veröffentlichung am 20. März 2026 um 10:00 UTC ein.

Bericht herunterladen:

Rufen Sie die URL für den Download- und Installationsbericht der letzten 30 Tage im englischen CSV-Format ab.

Veröffentlichungs-Workflow

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

1. Verwenden Sie update_app_info / update_language_info, um Metadaten und Versionshinweise festzulegen

2. Verwenden Sie upload_app_file, um die Binärdatei hochzuladen (handhabt das Chunking automatisch)

3. Verwenden Sie submit_app, um die Überprüfung und Veröffentlichung auszulösen

Paket-Veröffentlichungs-Workflow

Anweisungen zur Paketveröffentlichung finden Sie unter docs/RELEASE.md.

API-Referenz

Dieser Server kapselt die AppGallery Connect Publishing API.

Lizenz

MIT