HuaweiAppGalleryMcp

Huawei AppGallery MCP

Huawei AppGallery Connectでのアプリ公開を管理するためのModel Context Protocol（MCP）サーバーです。Claude Desktop、またはMCP対応の任意のクライアントと直接連携します。

機能

• アプリのメタデータ（名前、説明、カテゴリ、評価、サポート連絡先）を照会・更新
• 言語ごとにローカライズされたストア掲載情報を管理
• APK／AABファイルをアップロード（大容量ファイル（>4 GB）は自動的に分割アップロード）
• アプリを全体リリース、段階的（グレー）リリース、予約リリース、オープンテスト（channel_id=2）として申請
• バイナリが独自サーバーでホストされている場合にアプリを申請
• 段階的リリースのライフサイクルを管理（状態変更、割合の更新）
• AABのコンパイル状況を照会
• 予約リリース時刻を更新
• GMS依存フラグを設定
• ダウンロード／インストールおよびインストール失敗レポートのURLを取得

インストール

MCP Registry経由（推奨）

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 がデフォルトとして使用されます。

ツール	説明
query_app_info	アプリの現在のメタデータ（名前、説明、カテゴリ、評価など）を照会します。channel_id を指定すると、特定のリリースチャネルを対象にできます
update_app_info	AppGallery Connect の下書きにあるアプリのメタデータを更新します
update_language_info	特定の言語のストア掲載情報を追加または更新します
delete_language_info	ローカライズされたストア掲載情報を削除します
get_upload_url	ファイルをアップロードする前に、事前署名付きアップロード URL と認証コードを取得します
upload_app_file	ローカルディスク上の APK/AAB をアップロードし、アプリの下書きに添付します（4 GB を超える場合は自動で分割してアップロードします）
update_app_file_info	アップロード済みのファイルを手動でアプリの下書きに添付します
query_compile_status	1 つ以上のパッケージ ID の AAB コンパイル状況を照会します
submit_app	アプリを審査とリリースに提出します（通常、段階的、予約、channel_id=2 によるオープンテストに対応）
submit_app_with_file	バイナリを独自のサーバーでホストしている場合に提出します
change_phased_release_state	段階的リリースの状態を変更します：続行、ロールバック、または停止
update_phased_release	段階的リリースを通常リリースに切り替えるか、段階的公開のスケジュール／割合を更新します
update_release_time	予約リリースの日時を更新します（アプリがリリース中の状態の場合のみ）
set_gms_dependency	アプリが GMS に依存するかどうかを報告します
get_download_report_url	アプリのダウンロードおよびインストールレポートのダウンロード URL を取得します（CSV/Excel、最大 180 日分）
get_install_failure_report_url	インストール失敗レポートのダウンロード URL を取得します（CSV/Excel、最大 180 日分）

使用例

新しいバージョンをアップロードしてリリースする：

/path/to/app-release.aab（AAB、ファイルタイプ 5）をアップロードし、通常リリースとして提出します。

段階的公開：

アプリをユーザーの 20% に段階的リリースとして提出します。

オープンテスト：

アプリをオープンテスト（channel_id=2）に提出します。

オープンテストの確認：

query_app_info(channel_id=2) でオープンテストチャネルのアプリのメタデータを照会します。

リリースノートの更新：

英語のリリースノートを「Bug fixes and performance improvements」に更新します。

予約リリース：

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