PubShip

Name: PubShip
Author: pubship

已认证精选本地服务

pubship.dev开发工具02 周前更新

文档代码仓库访问官网

关于 PubShip

PubShip 是面向管理自有 Google Play 应用开发者的本地优先 MCP 服务，可检查发布、评价、报告和目录，并支持准备需明确授权的写入操作。

主要功能

01读取发布、评价、Vitals 和报告
02检查目录与账号资源
03准备并审核获授权的变更
04受限的本地文件传输

适用场景

01查看应用发布状态和用户反馈
02检查 Play Console 报告与资源
03暂存并批准应用或目录变更

MCP 相关

PubShip 以本地 stdio MCP 服务运行，使用运营者自己的 Google 服务账号和 Play Console 权限。它提供 Google Play 工作流工具；敏感读取和可选写入需显式配置。

#google-play #android-app #play-console-mcp

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "pubship-pubship": {
      "command": "uvx",
      "args": [
        "pubship"
      ]
    }
  }
}

启动命令uvx pubship

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypipubship0.24.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
method	string	是	精确固定的 Google 方法 ID，而非 URL；使用 list_api_methods 发现，并检查 describe_api_method。该方法必须受此工具支持，并已获准用于目标。
parameters	object	是	使用 describe_api_method 中的准确名称提供 Google 路径／查询参数；包含所有必需的目标标识符。支持时，请将请求 JSON 放在 body 中，而不是此处。分页时，重复使用筛选条件并传入返回的提供方令牌。

详细介绍

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

在启动客户端的 shell 中设置上述环境变量。更改环境后，请重启客户端。

Codex

codex mcp add pubship -- uvx pubship

Cursor 和 Gemini CLI

此代码库中的客户端清单会声明本地服务账号密钥路径和软件包名称。配置和 Gemini CLI 安装命令请参阅客户端设置。如需由 Agent 协助安装，请阅读 llms-install.md。仅提供密钥文件路径，切勿提供文件内容。

通用 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、报告和权限边界，请参阅设置。

它能做什么？

本地 API 覆盖范围

固定清单包含 172 个方法定义。其中 170 个已实现；Google 不支持其中一个订阅归档方法；根据项目策略，已明确禁用已撤销购买记录的访问。禁用的操作无法通过本地工具或可自托管工具调用。

读取版本、评价、Android vitals 和范围受限的批量报告。
在单独授予敏感数据权限的情况下，检查目录、订阅、商品和账号资源。
使用明确的应用/方法权限准备并审核写入操作，并通过一次性执行完成操作。
限制本地文件传输范围，并将发布操作与编辑暂存分开。

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

了解合约与边界

## 为自己的账户自行托管

pubship-server 保留了供你控制的基础设施使用的 HTTP 实现。未设置 PUBSHIP_SERVER_ALLOWED_EMAILS 时，服务会拒绝启动。登录前必须验证签名的 Google ID 令牌、完全匹配且已验证的邮箱，并绑定 nonce，之后才会保存任何 Google 凭据。从允许列表中移除某个账户后，其已存储的授权会在下次使用时失效。未经身份验证的旧授权需要重新连接。除非运营者明确启用，否则注册功能会保持关闭。

本项目不运行任何连接 Google 的服务。请参阅本地优先决策和自托管设置。

发布说明

PubShip 0.24.2 改进了工具描述和审批提示，并会检查源码安装与打包安装中的定义是否一致。更早版本请参阅更新日志。源码版本可能早于软件包发布。

开发

工具定义质量介绍了 TDQS 1.2 离线检查、经审核的启发式检查结果，以及 MCP 契约回归测试覆盖范围。离线检查不会根据模型评分。

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、Google Play 和 Android 是 Google LLC 的商标。