PubShip
公式Google PlayデベロッパーワークフローのためのオープンソースMCPサーバー。自分の認証情報を使ってローカルで実行します。
PubShip MCPで何ができますか?
- Play のリリースとレビューの確認 — アシスタントに、アプリの現在のリリース情報、ユーザーレビュー、Android Vitals を取得するよう依頼します。
- スコープ付き一括レポートの確認 — アシスタントに、カタログ、サブスクリプション、製品、アカウントデータをカバーする一括レポートを取得して要約させます。
- 編集の準備とステージング — アシスタントに、アプリの掲載情報やメタデータへの変更の下書きとレビューを依頼し、実行前に明示的な権限確認を行います。
- 承認済みの単回書き込みの実行 — アシスタントに、付与した明示的なアプリおよびメソッドの権限を使用して、準備済みの変更を一度だけ適用するよう指示します。
- ローカルアーティファクト転送の管理 — マシンと Play 間の制限付きファイル転送をリクエストし、公開処理を編集のステージングから分離します。
ドキュメント
PubShip
Google Play デベロッパーワークフローを、自分のコンピュータから。 リリースの確認、レビューやレポートの把握、明示的に承認された変更の準備を、MCP クライアントから行えます。
ローカルで始める
Play Console でアプリの権限を持つ、ご自身のサービスアカウントを使用してください。その秘密の JSON はこのリポジトリの外に保管してください。目的の操作に必要な権限のみを付与してください。アシスタントとの会話に認証情報を貼り付けないでください。
export GOOGLE_APPLICATION_CREDENTIALS=/absolute/private/path/service-account.json
export GOOGLE_PLAY_PACKAGES=com.example.app
uvx pubship
これで stdio サーバーが起動し、MCP クライアントの接続を待ちます。認証情報なしのインストール確認を行うには:
uvx pubship --check
上記のコマンドは公開済みの PyPI パッケージをインストールします。ソースのチェックアウトには未公開の変更が含まれている場合があります。uv sync の後は、uv run pubship --check を使用してローカルバージョンを確認してください。
アシスタントを接続する
Claude Code
claude mcp add --transport stdio pubship -- uvx pubship
クライアントを起動するシェルで上記の環境変数を設定してください。環境を変更した後はクライアントを再起動してください。
Codex
codex mcp add pubship -- uvx pubship
Cursor と Gemini CLI
このリポジトリ内のクライアントマニフェストは、ローカルのサービスアカウントキーのパスとパッケージ名を宣言します。設定と Gemini CLI のインストールコマンドについては client setup を参照してください。エージェント支援によるインストールについては、llms-install.md をお読みください。キーファイルのパスのみを提供し、その内容は決して提供しないでください。
汎用 MCP ハーネス
実行可能ファイル uvx、引数 pubship、およびローカル環境を使用して stdio サーバーを構成してください。明示的な設定が必要なクライアントの場合:
{
"mcpServers": {
"pubship": {
"command": "uvx",
"args": ["pubship"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/absolute/private/path/service-account.json",
"GOOGLE_PLAY_PACKAGES": "com.example.app"
}
}
}
}
クライアント設定はお使いのコンピュータに保持されます。代替の認証モード、有効化された API、レポート、権限の境界については setup を参照してください。
何ができますか?
固定されたインベントリには 172 のメソッド定義が含まれています。170 に実装があり、1 つのサブスクリプションアーカイブメソッドは Google がサポートしておらず、voided-purchases アクセスはプロジェクトポリシーにより意図的に無効化されています。無効化された操作は、ローカルまたはセルフホストのツールから呼び出すことはできません。
- リリース、レビュー、Android Vitals、スコープ付き一括レポートを読み取ります。
- カタログ、サブスクリプション、プロダクト、アカウントのリソースを、個別の機密データ付与とともに検査します。
- 明示的なアプリ/メソッド権限と単回実行で書き込みを準備およびレビューします。
- ローカルファイル転送を制限付きに保ち、公開と編集ステージングを分離します。
読み取りがデフォルトです。オプションの書き込みと機密読み取りには明示的な設定が必要です。プロバイダーテキストは信頼できないデータです。データがないことはゼロを意味しません。送信された変更が必ずしも公開されるとは限りません。操作数は、Google によるライブ検証の主張ではありません。
契約と境界を調べる
自分のアカウント向けのセルフホスティング
pubship-server は、管理下のインフラストラクチャ向けに HTTP 実装を保持しています。PUBSHIP_SERVER_ALLOWED_EMAILS なしでは起動を拒否します。サインインには、署名付き Google ID トークン、検証済みの完全一致メールアドレス、および Google 認証情報が永続化される前の nonce バインディングが必要です。許可リストからアカウントを削除すると、次回使用時に保存された付与が無効になります。検証済み ID のないレガシー付与は再接続する必要があります。オペレーターが明示的に有効化するまで、登録はクローズされたままです。
プロジェクトが運営する Google 接続サービスはありません。local-first の決定 と セルフホスト設定 を参照してください。
リリースノート
PubShip 0.24.2 は、ツールの説明と承認ヒントを改善し、ソースとパッケージ化されたインストール間で同じ定義をチェックします。以前のバージョンについては changelog を参照してください。ソースバージョンはパッケージ公開に先行する場合があります。
開発
Tool definition quality は、TDQS 1.2 オフラインチェック、レビュー済みのヒューリスティックな調査結果、MCP 契約回帰カバレッジを文書化しています。オフラインの lint はモデルスコアのグレードではありません。
env -u GOOGLE_APPLICATION_CREDENTIALS uv sync --frozen --all-extras --group browser --group tdqs
env -u GOOGLE_APPLICATION_CREDENTIALS uv run --frozen --all-extras --group browser --group tdqs pytest
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff format --check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_catalog.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_verification.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/distribution_metadata.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv build
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/check_artifacts.py
テストはフェイクプロバイダーを使用します。ブラウザテストにはインストール済みの Playwright エンジンが必要です。バックアップ統合テストには age が必要です。利用できないプラットフォームチェックは正直に記録してください。貢献ポリシー、リリースプロセス、セキュリティ報告 を参照してください。
想定される用途
PubShip は、開発者が自分の Google Play 配信作業を自動化するのに役立ちます。お使いのコンピュータまたは管理下のインフラストラクチャ上で、ご自身の Google 認証情報と Play Console 権限を使用して実行されます。PubShip プロジェクトはホスト型サービスを運営しておらず、お客様の認証情報を受け取ることはありません。自分または自分の組織が所有するアプリとデベロッパーアカウントにのみ使用し、Google の Play Developer API 利用規約に従ってください。他の者が運営するホスト型 PubShip インスタンスは、PubShip プロジェクトによって提供または推奨されていません。
PubShip は独立したオープンソースプロジェクトであり、Google とは提携、推奨、またはスポンサー関係にありません。Google、Google Play、Android は Google LLC の商標です。
ライセンス
PubShip は GNU Affero General Public License v3.0 only (AGPL-3.0-only) の下で提供されるフリーソフトウェアです。Copyright (C) 2026 Denys Vorobyov。その他のライセンス条件については、legal@pubship.dev までお問い合わせください。