Huawei AppGallery MCP

Huawei AppGallery Connectでのアプリ公開を管理するためのModel Context Protocol (MCP) サーバーです。Claude DesktopやMCP互換クライアントと直接統合できます。

機能

• アプリのメタデータ（名前、説明、カテゴリ、評価、サポート連絡先）の照会と更新

• 言語ごとのローカライズされたストア掲載情報の管理

• 大容量ファイル（>4 GB）の自動チャンクアップロードに対応したAPK / AABファイルのアップロード

• フルリリース、段階的（グレー）リリース、予約リリース、またはオープンベータテスト（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. 作成 をクリックし、アプリ管理者 ロールを選択します

4. クライアントID と クライアントシークレット をコピーします

これらは 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) を使用して、オープンベータテストチャネルのアプリメタデータを照会します。

リリースノートの更新:

英語のリリースノートを「バグ修正とパフォーマンスの向上」に更新します。

予約リリース:

2026年3月20日 10:00 UTCにリリースされるようアプリを提出します。

レポートのダウンロード:

過去30日間のダウンロードおよびインストールレポートのURLを英語の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