gpc-mcp-server

🤖 Google Play Console MCP サーバー

AI アシスタント（Claude、Gemini、またはあらゆる MCP クライアントなど）から Google Play Console を直接管理できる、強力な Model Context Protocol (MCP) サーバーです。

アプリをリリースするために、遅いウェブインターフェースをクリックして回るのはやめましょう。AI エージェントに頼むだけです。

「Claude、本番環境のクラッシュ率はどれくらいですか？」 「Gemini、新しい内部テスト用リリースを作成して、リリースノートを更新してください。」 「Claude、今日の星1のレビューを一覧表示して、詳細を尋ねる返信をしてください。」

---

🌟 主な機能

• 🚀 リリース管理： リリースの作成、トラックの管理、リリースノートの更新、段階的な公開の制御ができます。
• 📊 アプリの品質とレポート： 獲得データ、クラッシュ率、ANR 統計をすぐに取得できます。
• 💬 レビュー管理： ユーザーレビューの閲覧、評価による絞り込み、返信の自動投稿ができます。
• 🖼️ ストア掲載情報： ストアの掲載情報や翻訳の更新、スクリーンショット／フィーチャー画像の管理ができます。

🛠️ 提供されるツール

この MCP サーバーは、AI エージェントに 65 個のツールを公開します。主なツール：

📦 アプリと掲載情報

• gpc_get_app_info - アプリの詳細（パッケージ名、デフォルト言語、連絡先情報）を取得します
• gpc_list_listings - すべてのロケールのストア掲載情報を取得します
• gpc_update_listing - 指定したロケールのストア掲載情報を更新します

🚀 リリースとトラックの管理

• gpc_list_tracks - トラック（内部テスト、アルファ、ベータ、本番環境）と現在のリリースを一覧表示します
• gpc_create_release - 指定したトラックに新しいリリースを作成します
• gpc_update_release_notes - 最新リリースのリリースノートを更新します
• gpc_set_rollout - 段階的な公開の割合を設定／更新します
• gpc_halt_rollout - 進行中の段階的な公開を停止します

💬 レビュー

• gpc_list_reviews - 評価と返信状況を含むユーザーレビューを取得します
• gpc_reply_review - ユーザーレビューに返信を投稿します

📈 レポートと品質

• gpc_acquisition_report - インストール数／獲得数の統計を取得します
• gpc_crash_report - Android Vitals からクラッシュ率と ANR 率を取得します
• gpc_crash_anomaly_detector - 直近2日間のクラッシュ率を、それ以前の12日間の基準値と比較して、段階的な公開を停止すべきスパイク（🚨）を検出します

📸 スクリーンショットと画像

• gpc_list_images - 指定したロケールにアップロード済みの画像を一覧表示します
• gpc_upload_image - スクリーンショット／フィーチャー画像／アイコンをアップロードします
• gpc_upload_images_batch - 1回の編集で複数のロケールに多数の画像をアップロードします（新しいロケールの初期登録に必須です。Play ではコミット時にスマートフォン向けスクリーンショットが2枚以上必要なため、ファイルごとにコミットすると「スクリーンショットが少なすぎます」というエラーが発生します）
• gpc_delete_image - 指定した画像を削除します

---

⚙️ クイックスタート

1. サービスアカウントキーを取得する

1. Google Cloud Console にアクセスします。
2. **「Google Play Android Developer API」**を有効にします。
3. サービスアカウントを作成し、JSON キーをダウンロードします。
4. Google Play Console > Setup > API access で：
   • Google Cloud プロジェクトをリンクします。
   • サービスアカウントに**「Admin」または「Release manager」**の権限を付与します。

2. インストール

このリポジトリをクローンしてビルドします：

git clone https://github.com/YOUR_USERNAME/gpc-mcp-server.git
cd gpc-mcp-server
npm install
npm run build

3. Claude Code（または任意の MCP クライアント）に接続する

claude mcp add コマンドを使用して、このサーバーを Claude 環境に追加します：

claude mcp add --scope user gpc-mcp \
  -e GOOGLE_PLAY_SERVICE_ACCOUNT_JSON=/path/to/your/service-account.json \
  -e GOOGLE_PLAY_PACKAGE_NAME=com.yourcompany.appname \
  -- node /path/to/gpc-mcp-server/dist/index.js

必要な環境変数

変数	説明	例
GOOGLE_PLAY_SERVICE_ACCOUNT_JSON	サービスアカウント JSON キーの絶対パス	/users/me/secrets/play-store.json
GOOGLE_PLAY_PACKAGE_NAME	Android アプリケーションのパッケージ名	com.example.myapp

---

🤖 AI プロンプトの例

設定が完了したら、AI エージェントに自然に話しかけるだけで利用できます。

アプリの健全性を確認：

「今日、アプリで新たなクラッシュは発生していますか？」 -> エージェントが gpc_crash_report を呼び出します

ロールアウトの安全性を確認：

「最新のロールアウトは安全ですか？それとも停止すべきですか？」 -> エージェントが gpc_crash_anomaly_detector を呼び出し、急増が検出された場合は gpc_halt_rollout を呼び出します

リリースのワークフロー：

「新しい内部リリースを作成して、トルコ語のリリースノートを『Bug fixes』に更新してください。」 -> エージェントが gpc_create_release と gpc_update_release_notes を呼び出します

カスタマーサポート：

「今週の星1つのレビューをすべて探して、返信の下書きを作成してください。」 -> エージェントが gpc_list_reviews と gpc_reply_review を呼び出します

Git からリリースノートを自動生成：

「前回のタグ以降のコミットを確認して、ユーザーにわかりやすいリリースノートを作成し、公開してください。」 -> エージェントがローカルの Git 履歴を読み取り、文章を作成して、gpc_update_release_notes を呼び出します

ストア掲載情報の最適化：

「現在のストア掲載情報を取得し、コンバージョン率向上につながる、より魅力的な短い説明文を提案してください。」 -> エージェントが gpc_list_listings を呼び出して現在の文章を読み取り、続いて gpc_update_listing を呼び出して新しい内容を公開します

---

📝 対応ロケール

Play Console の標準ロケール（en-US、tr-TR、de-DE、es-419、fr-FR、ru-RU、ar など多数）に対応しています。

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。