PubShip

官方

開源MCP伺服器，用於Google Play開發者工作流程。使用您自己的憑證在本機執行。

GitHub試用此 MCP贊助

你可以用 PubShip MCP 做什麼？

  • 檢查 Play 發布版本與評論 — 請助理擷取您應用程式目前的發布資訊、使用者評論及 Android 效能指標。
  • 檢視範圍內的大量報表 — 請助理擷取並摘要涵蓋目錄、訂閱、產品及帳戶資料的大量報表。
  • 準備並暫存編輯內容 — 請助理在明確的權限檢查下草擬與審查應用程式變更，並將編輯內容與發布作業分開處理。
  • 管理本機檔案傳輸 — 指示助理處理您機器與 Play Console 之間的有限檔案傳輸，且不混雜暫存與即時更新。

文件

PubShip

Google Play 開發者工作流程，直接在你的電腦上執行。 檢查發布版本、理解評論與報告，並從你的 MCP 用戶端準備明確授權的變更。

CI Release AGPL-3.0-only PubShip MCP server – quality and maintenance score on Glama

在本機啟動

使用你自己的服務帳戶，並在 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

版本 0.24.0 是 PubShip 的第一個候選發布版。PyPI 與 MCP Registry 的發布是獨立步驟，不包含在此簽出版本中。在正式發布前，請在 uv sync 之後，從原始碼簽出版使用 uv run pubship --check。

連接助理

Claude Code

claude mcp add --transport stdio pubship -- uvx pubship

在啟動用戶端的 shell 中設定上述環境變數。變更環境後請重新啟動用戶端。

Codex

codex mcp add pubship -- uvx pubship

通用 MCP 框架

設定一個 stdio 伺服器，使用可執行檔 uvx、參數 pubship 以及你的本機環境。對於需要明確設定的用戶端：

{
  "mcpServers": {
    "pubship": {
      "command": "uvx",
      "args": ["pubship"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/private/path/service-account.json",
        "GOOGLE_PLAY_PACKAGES": "com.example.app"
      }
    }
  }
}

用戶端設定保留在你的電腦上。請參閱 設定 以了解其他驗證模式、已啟用的 API、報告與權限邊界。

它能做什麼？

Local API coverage

固定的清單包含 172 個方法定義。其中 170 個有實作，一個訂閱封存方法不受 Google 支援，而作廢購買存取則因專案政策而刻意停用。停用的操作無法透過本機或自架工具呼叫。

  • 讀取發布版本、評論、Android Vitals 與範圍化的批次報告。
  • 以獨立的敏感資料授權檢查目錄、訂閱、產品與帳戶資源。
  • 以明確的應用程式/方法權限與單次執行，準備並審查寫入操作。
  • 保持本機檔案傳輸的範圍限制，並將發布與編輯暫存分離。

讀取是預設行為。選用的寫入與敏感讀取需要明確設定。提供者文字是不可信的資料。缺少資料不代表為零；已提交的變更不一定會發布。任何操作數量都不代表已通過 Google 的即時驗證。

探索合約與邊界

為你自己的帳戶自架服務

pubship-server 保留 HTTP 實作，供你控制的基礎設施使用。若缺少 PUBSHIP_SERVER_ALLOWED_EMAILS，它會拒絕啟動。登入需要簽署的 Google ID 權杖、驗證過的完全相符電子郵件，以及在持久化任何 Google 憑證之前完成 nonce 綁定。從允許清單中移除帳戶，會使其儲存的授權在下一次使用時失效。沒有經過驗證身分的舊授權必須重新連線。註冊會保持關閉，直到操作者明確啟用。

本專案沒有營運任何由 Google 連線的服務。請參閱 本機優先的決策 與 自架設定。

開發

env -u GOOGLE_APPLICATION_CREDENTIALS uv sync --all-extras --group browser
env -u GOOGLE_APPLICATION_CREDENTIALS uv run 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、Google Play 與 Android 是 Google LLC 的商標。

授權

PubShip 是自由軟體，僅依 GNU Affero General Public License v3.0（AGPL-3.0-only）授權。版權所有（C）2026 Denys Vorobyov。如需其他授權條款，請聯絡 legal@pubship.dev。

商標 · 第三方聲明 · 網站