PubShip
chính thứcMáy chủ MCP mã nguồn mở cho quy trình làm việc của nhà phát triển Google Play. Chạy cục bộ với thông tin xác thực của riêng bạn
Bạn có thể làm gì với PubShip MCP?
- Kiểm tra bản phát hành và đánh giá trên Play — Yêu cầu trợ lý của bạn lấy thông tin phát hành hiện tại, đánh giá người dùng và số liệu Android vitals cho các ứng dụng của bạn.
- Xem xét báo cáo tổng hợp theo phạm vi — Nhờ trợ lý tìm nạp và tóm tắt các báo cáo tổng hợp bao gồm dữ liệu danh mục, đăng ký, sản phẩm và tài khoản.
- Chuẩn bị và sắp xếp các chỉnh sửa — Yêu cầu trợ lý soạn thảo và xem xét các thay đổi đối với danh sách ứng dụng hoặc siêu dữ liệu, với các kiểm tra quyền rõ ràng trước khi thực hiện.
- Thực hiện các thao tác ghi đã được phê duyệt dùng một lần — Hướng dẫn trợ lý áp dụng một thay đổi đã chuẩn bị một lần, sử dụng quyền ứng dụng và phương thức rõ ràng mà bạn đã cấp.
- Quản lý chuyển tệp cục bộ — Yêu cầu chuyển tệp có giới hạn giữa máy của bạn và Play, giữ việc xuất bản tách biệt với việc sắp xếp chỉnh sửa.
Tài liệu
PubShip
Quy trình làm việc với Google Play dành cho nhà phát triển, ngay từ máy tính của bạn. Kiểm tra các bản phát hành, hiểu đánh giá và báo cáo, đồng thời chuẩn bị các thay đổi được ủy quyền rõ ràng từ MCP client của bạn.
Bắt đầu cục bộ
Sử dụng tài khoản dịch vụ của riêng bạn với quyền truy cập cho các ứng dụng của bạn trong Play Console. Giữ tệp JSON riêng tư của tài khoản này bên ngoài kho lưu trữ. Chỉ cấp các quyền cần thiết cho các thao tác bạn dự định thực hiện. Không bao giờ dán thông tin xác thực vào cuộc trò chuyện với trợ lý.
export GOOGLE_APPLICATION_CREDENTIALS=/absolute/private/path/service-account.json
export GOOGLE_PLAY_PACKAGES=com.example.app
uvx pubship
Thao tác này khởi động máy chủ stdio, máy chủ này sẽ chờ MCP client. Để kiểm tra cài đặt mà không cần thông tin xác thực:
uvx pubship --check
Các lệnh trên cài đặt gói PyPI đã phát hành. Bản kiểm tra mã nguồn có thể chứa các thay đổi chưa được phát hành; sau uv sync, hãy sử dụng uv run pubship --check để kiểm tra phiên bản cục bộ.
Kết nối trợ lý
Claude Code
claude mcp add --transport stdio pubship -- uvx pubship
Đặt các biến môi trường ở trên trong shell khởi chạy client của bạn. Khởi động lại client sau khi thay đổi môi trường của nó.
Codex
codex mcp add pubship -- uvx pubship
Cursor và Gemini CLI
Các tệp kê khai client trong kho lưu trữ này khai báo đường dẫn khóa tài khoản dịch vụ cục bộ và tên gói. Xem thiết lập client để biết cấu hình và lệnh cài đặt Gemini CLI. Để cài đặt có hỗ trợ từ trợ lý, hãy đọc llms-install.md. Chỉ cung cấp đường dẫn tệp khóa, không bao giờ cung cấp nội dung của tệp.
Khung MCP chung
Cấu hình máy chủ stdio với tệp thực thi uvx, đối số pubship và môi trường cục bộ của bạn. Đối với các client yêu cầu cấu hình tường minh:
{
"mcpServers": {
"pubship": {
"command": "uvx",
"args": ["pubship"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/absolute/private/path/service-account.json",
"GOOGLE_PLAY_PACKAGES": "com.example.app"
}
}
}
}
Cấu hình client vẫn nằm trên máy tính của bạn. Tham khảo thiết lập để biết các chế độ xác thực thay thế, API đã bật, báo cáo và ranh giới quyền.
Nó có thể làm gì?
Danh mục cố định chứa 172 định nghĩa phương thức. 170 phương thức có triển khai, một phương thức lưu trữ đăng ký không được Google hỗ trợ và quyền truy cập giao dịch mua bị vô hiệu hóa được cố ý vô hiệu hóa theo chính sách dự án. Các thao tác bị vô hiệu hóa không thể được gọi thông qua các công cụ cục bộ hoặc tự lưu trữ.
- Đọc bản phát hành, đánh giá, Android vitals và báo cáo hàng loạt có phạm vi.
- Kiểm tra tài nguyên danh mục, đăng ký, sản phẩm và tài khoản với các cấp quyền nhạy cảm riêng biệt.
- Chuẩn bị và xem xét các thao tác ghi với quyền ứng dụng/phương thức rõ ràng và thực thi một lần.
- Giữ các chuyển tệp cục bộ có giới hạn và tách biệt việc xuất bản khỏi giai đoạn chỉnh sửa.
Đọc là mặc định. Ghi tùy chọn và đọc dữ liệu nhạy cảm yêu cầu cấu hình rõ ràng. Văn bản nhà cung cấp là dữ liệu không đáng tin cậy. Dữ liệu bị thiếu không phải là số không; một thay đổi được gửi không nhất thiết đã được phát hành. Không có số lượng thao tác nào là tuyên bố xác minh trực tiếp của Google.
Khám phá các hợp đồng và ranh giới
Tự lưu trữ cho tài khoản của riêng bạn
pubship-server giữ lại triển khai HTTP cho cơ sở hạ tầng bạn kiểm soát. Nó từ chối khởi động nếu không có PUBSHIP_SERVER_ALLOWED_EMAILS. Đăng nhập yêu cầu mã thông báo Google ID đã ký, khớp chính xác email đã xác minh và ràng buộc nonce trước khi bất kỳ thông tin xác thực Google nào được lưu trữ. Xóa tài khoản khỏi danh sách cho phép sẽ vô hiệu hóa các cấp quyền đã lưu của tài khoản đó trong lần sử dụng tiếp theo. Các cấp quyền cũ không có danh tính đã xác minh phải kết nối lại. Việc đăng ký vẫn đóng cho đến khi người vận hành bật nó một cách rõ ràng.
Không có dịch vụ kết nối Google do dự án vận hành. Xem quyết định ưu tiên cục bộ và thiết lập tự lưu trữ.
Ghi chú phát hành
PubShip 0.24.2 cải thiện mô tả công cụ và gợi ý phê duyệt, đồng thời kiểm tra cùng các định nghĩa trên các bản cài đặt từ mã nguồn và gói. Xem nhật ký thay đổi cho các phiên bản trước. Phiên bản mã nguồn có thể có trước khi gói được phát hành.
Phát triển
Chất lượng định nghĩa công cụ ghi lại các kiểm tra ngoại tuyến TDQS 1.2, các phát hiện heuristic đã xem xét và phạm vi kiểm tra hồi quy hợp đồng MCP. Lint ngoại tuyến không phải là điểm được mô hình chấm.
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
Các bài kiểm tra sử dụng nhà cung cấp giả. Bài kiểm tra trình duyệt yêu cầu công cụ Playwright đã cài đặt; bài kiểm tra tích hợp sao lưu yêu cầu age. Ghi lại các kiểm tra nền tảng không khả dụng một cách trung thực. Xem chính sách đóng góp, quy trình phát hành và báo cáo bảo mật.
Mục đích sử dụng
PubShip giúp các nhà phát triển tự động hóa công việc phân phối Google Play của chính họ. Nó chạy trên máy tính của bạn hoặc trên cơ sở hạ tầng bạn kiểm soát, với thông tin xác thực Google và quyền Play Console của riêng bạn. Dự án PubShip không vận hành dịch vụ lưu trữ và không bao giờ nhận thông tin xác thực của bạn. Chỉ sử dụng nó cho các ứng dụng và tài khoản nhà phát triển mà bạn hoặc tổ chức của bạn sở hữu, đồng thời tuân theo Điều khoản API Play Developer của Google. Các phiên bản PubShip được lưu trữ bởi người khác không được dự án PubShip cung cấp hoặc xác nhận.
PubShip là một dự án mã nguồn mở độc lập và không liên kết, được xác nhận hoặc tài trợ bởi Google. Google, Google Play và Android là nhãn hiệu của Google LLC.
Giấy phép
PubShip là phần mềm miễn phí theo Giấy phép Công cộng GNU Affero v3.0 chỉ (AGPL-3.0-only). Bản quyền (C) 2026 Denys Vorobyov. Đối với các điều khoản giấy phép khác, hãy liên hệ legal@pubship.dev.