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 支持，而 voided-purchases 访问权限因项目政策而被有意禁用。禁用操作无法通过本地或自托管工具调用。

  • 读取发布版本、评论、Android vitals 和限定范围的批量报告。
  • 通过独立的敏感数据授权，检查目录、订阅、产品和账户资源。
  • 使用显式的应用/方法权限和一次性执行来准备和审查写入操作。
  • 保持本地文件传输有界，并将发布与编辑暂存分离。

读取是默认操作。可选的写入和敏感读取需要显式配置。提供方文本是不可信数据。缺失数据不等于零；已提交的更改不一定已发布。任何操作数量都不代表已通过 Google 实时验证。

探索契约和边界

为你自己的账户自托管

pubship-server 为你控制的基础设施保留了 HTTP 实现。如果没有 PUBSHIP_SERVER_ALLOWED_EMAILS，它将拒绝启动。登录要求先提供经过签名的 Google ID 令牌、经过验证的精确邮箱匹配以及 nonce 绑定，之后才会持久化任何 Google 凭据。从允许列表中移除账户后，其已存储的授权将在下次使用时失效。没有经过验证身份的旧授权必须重新连接。注册保持关闭状态，直到操作员明确启用它。

项目不运行任何由 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、Google Play 和 Android 是 Google LLC 的商标。

许可证

PubShip 是自由软件，仅依据 GNU Affero 通用公共许可证 v3.0（AGPL-3.0-only）发布。版权所有（C）2026 Denys Vorobyov。如需其他许可条款，请联系 legal@pubship.dev。

商标 · 第三方声明 · 网站