PubShip
resmiServer MCP sumber terbuka untuk alur kerja developer Google Play. Berjalan secara lokal dengan kredensial Anda sendiri.
Apa yang bisa Anda lakukan dengan PubShip MCP?
- Memeriksa rilis dan ulasan Play — Minta asisten Anda untuk menarik info rilis terkini, ulasan pengguna, dan Android vitals untuk aplikasi Anda.
- Meninjau laporan massal terbatas — Minta asisten Anda mengambil dan merangkum laporan massal yang mencakup data katalog, langganan, produk, dan akun.
- Menyiapkan dan menahapkan edit — Minta asisten Anda menyusun dan meninjau perubahan pada listingan aplikasi atau metadata, dengan pemeriksaan izin eksplisit sebelum eksekusi.
- Menjalankan penulisan sekali pakai yang disetujui — Instruksikan asisten Anda untuk menerapkan perubahan yang telah disiapkan satu kali, menggunakan izin aplikasi dan metode eksplisit yang telah Anda berikan.
- Mengelola transfer artefak lokal — Minta transfer file terbatas antara mesin Anda dan Play, menjaga publikasi tetap terpisah dari penahapan edit.
Dokumentasi
PubShip
Alur kerja developer Google Play, dari komputer Anda sendiri. Periksa rilis, pahami ulasan dan laporan, serta siapkan perubahan yang diotorisasi secara eksplisit dari klien MCP Anda.
Mulai secara lokal
Gunakan akun layanan Anda sendiri dengan izin untuk aplikasi Anda di Play Console. Simpan JSON privatnya di luar repositori ini. Berikan hanya izin yang diperlukan untuk operasi yang Anda maksudkan. Jangan pernah menempelkan kredensial ke dalam percakapan asisten.
export GOOGLE_APPLICATION_CREDENTIALS=/absolute/private/path/service-account.json
export GOOGLE_PLAY_PACKAGES=com.example.app
uvx pubship
Ini memulai server stdio, yang menunggu klien MCP. Untuk pemeriksaan instalasi tanpa kredensial:
uvx pubship --check
Perintah di atas menginstal paket PyPI yang diterbitkan. Pemeriksaan sumber mungkin berisi perubahan yang belum diterbitkan; setelah uv sync, gunakan uv run pubship --check untuk memeriksa versi lokal.
Hubungkan asisten
Claude Code
claude mcp add --transport stdio pubship -- uvx pubship
Atur variabel lingkungan di atas di shell yang meluncurkan klien Anda. Mulai ulang klien setelah mengubah lingkungannya.
Codex
codex mcp add pubship -- uvx pubship
Cursor dan Gemini CLI
Manifes klien di repositori ini mendeklarasikan jalur kunci akun layanan lokal dan nama paket. Lihat penyiapan klien untuk konfigurasi dan perintah instalasi Gemini CLI. Untuk instalasi berbantuan agen, baca llms-install.md. Berikan hanya jalur file kunci, jangan pernah isinya.
Kerangka kerja MCP generik
Konfigurasikan server stdio dengan executable uvx, argumen pubship, dan lingkungan lokal Anda. Untuk klien yang memerlukan konfigurasi eksplisit:
{
"mcpServers": {
"pubship": {
"command": "uvx",
"args": ["pubship"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/absolute/private/path/service-account.json",
"GOOGLE_PLAY_PACKAGES": "com.example.app"
}
}
}
}
Konfigurasi klien tetap berada di komputer Anda. Konsultasikan penyiapan untuk mode autentikasi alternatif, API yang diaktifkan, laporan, dan batas izin.
Apa yang bisa dilakukannya?
Inventaris yang dipatok berisi 172 definisi metode. 170 memiliki implementasi, satu metode arsip langganan tidak didukung oleh Google, dan akses pembelian yang dibatalkan sengaja dinonaktifkan oleh kebijakan proyek. Operasi yang dinonaktifkan tidak dapat dipanggil melalui alat lokal atau yang dihosting sendiri.
- Baca rilis, ulasan, Android vitals, dan laporan massal yang dibatasi cakupannya.
- Periksa sumber daya katalog, langganan, produk, dan akun dengan hibah data sensitif terpisah.
- Siapkan dan tinjau penulisan dengan izin aplikasi/metode eksplisit dan eksekusi sekali pakai.
- Jaga transfer file lokal tetap terbatas dan pisahkan publikasi dari pementasan pengeditan.
Pembacaan adalah default. Penulisan opsional dan pembacaan sensitif memerlukan konfigurasi eksplisit. Teks penyedia adalah data yang tidak tepercaya. Data yang hilang bukan nol; perubahan yang dikirimkan belum tentu diterbitkan. Tidak ada jumlah operasi yang merupakan klaim verifikasi langsung Google.
Jelajahi kontrak dan batasan
Hosting sendiri untuk akun Anda sendiri
pubship-server mempertahankan implementasi HTTP untuk infrastruktur yang Anda kendalikan. Ia menolak untuk memulai tanpa PUBSHIP_SERVER_ALLOWED_EMAILS. Masuk memerlukan token ID Google yang ditandatangani, kecocokan email persis yang terverifikasi, dan pengikatan nonce sebelum kredensial Google apa pun disimpan. Menghapus akun dari daftar izin membatalkan hibah tersimpannya pada penggunaan berikutnya. Hibah lama tanpa identitas terverifikasi harus terhubung kembali. Pendaftaran tetap ditutup sampai operator secara eksplisit mengaktifkannya.
Tidak ada layanan terhubung Google yang dijalankan proyek. Lihat keputusan lokal-pertama dan penyiapan hosting sendiri.
Catatan rilis
PubShip 0.24.2 meningkatkan deskripsi alat dan petunjuk persetujuan, serta memeriksa definisi yang sama di seluruh instalasi sumber dan paket. Lihat changelog untuk versi sebelumnya. Versi sumber dapat mendahului publikasi paket.
Pengembangan
Kualitas definisi alat mendokumentasikan pemeriksaan offline TDQS 1.2, temuan heuristik yang ditinjau, dan cakupan regresi kontrak MCP. Lint offline bukanlah nilai yang dinilai model.
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
Tes menggunakan penyedia palsu. Tes browser memerlukan mesin Playwright yang terinstal; tes integrasi cadangan memerlukan age. Catat pemeriksaan platform yang tidak tersedia dengan jujur. Lihat kebijakan kontribusi, proses rilis, dan pelaporan keamanan.
Penggunaan yang dimaksudkan
PubShip membantu developer mengotomatiskan pekerjaan distribusi Google Play mereka sendiri. Ia berjalan di komputer Anda atau di infrastruktur yang Anda kendalikan, dengan kredensial Google dan izin Play Console Anda sendiri. Proyek PubShip tidak menjalankan layanan yang dihosting dan tidak pernah menerima kredensial Anda. Gunakan hanya untuk aplikasi dan akun developer yang Anda atau organisasi Anda miliki, dan ikuti Ketentuan API Developer Google Play. Instans PubShip yang dihosting oleh pihak lain tidak disediakan atau didukung oleh proyek PubShip.
PubShip adalah proyek sumber terbuka independen dan tidak berafiliasi dengan, didukung oleh, atau disponsori oleh Google. Google, Google Play, dan Android adalah merek dagang Google LLC.
Lisensi
PubShip adalah perangkat lunak bebas di bawah GNU Affero General Public License v3.0 saja (AGPL-3.0-only). Hak cipta (C) 2026 Denys Vorobyov. Untuk ketentuan lisensi lainnya, hubungi legal@pubship.dev.