PubShip

ทางการ

เซิร์ฟเวอร์ MCP แบบโอเพนซอร์สสำหรับขั้นตอนการทำงานของนักพัฒนา Google Play ทำงานในเครื่องของคุณเองด้วยข้อมูลประจำตัวของคุณ

คุณทำอะไรได้บ้างด้วย PubShip MCP?

  • ตรวจสอบข้อมูล Play releases และรีวิว — ขอให้ผู้ช่วยของคุณดึงข้อมูล release ล่าสุด รีวิวจากผู้ใช้ และ Android vitals สำหรับแอปของคุณ
  • ตรวจสอบรายงานสรุปแบบแบ่งขอบเขต — ให้ผู้ช่วยของคุณดึงและสรุปรายงานแบบกลุ่มที่ครอบคลุมข้อมูลแคตตาล็อก การสมัครสมาชิก ผลิตภัณฑ์ และบัญชี
  • เตรียมและจัดเตรียมการแก้ไข — ขอให้ผู้ช่วยของคุณร่างและตรวจสอบการเปลี่ยนแปลงรายการแอปหรือข้อมูลเมตา โดยมีการตรวจสอบสิทธิ์อย่างชัดเจนก่อนดำเนินการ
  • ดำเนินการเขียนที่ได้รับอนุมัติแบบใช้ครั้งเดียว — สั่งให้ผู้ช่วยของคุณใช้การเปลี่ยนแปลงที่เตรียมไว้หนึ่งครั้ง โดยใช้สิทธิ์แอปและเมธอดที่คุณอนุญาตอย่างชัดเจน
  • จัดการการโอนไฟล์ในเครื่อง — ขอการโอนไฟล์ที่มีขอบเขตจำกัดระหว่างเครื่องของคุณและ Play โดยแยกการเผยแพร่ออกจากการจัดเตรียมการแก้ไข

เอกสาร

PubShip

เวิร์กโฟลว์สำหรับนักพัฒนา Google Play จากคอมพิวเตอร์ของคุณเอง ตรวจสอบรีลีส ทำความเข้าใจรีวิวและรายงาน และเตรียมการเปลี่ยนแปลงที่ได้รับอนุญาตอย่างชัดเจนจาก MCP client ของคุณ

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

เริ่มต้นใช้งานในเครื่อง

ใช้ service account ของคุณเองที่มีสิทธิ์สำหรับแอปของคุณใน Play Console เก็บไฟล์ private JSON ไว้นอก repository นี้ ให้สิทธิ์เฉพาะที่จำเป็นสำหรับการดำเนินการที่คุณต้องการเท่านั้น ห้ามวางข้อมูลประจำตัวลงในการสนทนากับผู้ช่วย

export GOOGLE_APPLICATION_CREDENTIALS=/absolute/private/path/service-account.json
export GOOGLE_PLAY_PACKAGES=com.example.app
uvx pubship

คำสั่งนี้จะเริ่มเซิร์ฟเวอร์ stdio ซึ่งรอรับ MCP client สำหรับการตรวจสอบการติดตั้งโดยไม่ต้องใช้ข้อมูลประจำตัว:

uvx pubship --check

คำสั่งด้านบนติดตั้งแพ็กเกจ PyPI ที่เผยแพร่แล้ว การเช็คเอาต์จากซอร์สอาจมีการเปลี่ยนแปลงที่ยังไม่ได้เผยแพร่ หลังจาก uv sync ให้ใช้ uv run pubship --check เพื่อตรวจสอบเวอร์ชันในเครื่อง

เชื่อมต่อผู้ช่วย

Claude Code

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

ตั้งค่าตัวแปรสภาพแวดล้อมด้านบนในเชลล์ที่ใช้เปิด client ของคุณ รีสตาร์ท client หลังจากเปลี่ยนสภาพแวดล้อม

Codex

codex mcp add pubship -- uvx pubship

Cursor และ Gemini CLI

Manifest ของ client ใน repository นี้ประกาศพาธไฟล์คีย์ service account ในเครื่องและชื่อแพ็กเกจ ดู การตั้งค่า client สำหรับการกำหนดค่าและคำสั่งติดตั้ง Gemini CLI สำหรับการติดตั้งโดยใช้ตัวช่วย อ่าน llms-install.md ระบุเฉพาะพาธไฟล์คีย์เท่านั้น ห้ามระบุเนื้อหาของไฟล์

Generic MCP harness

กำหนดค่าเซิร์ฟเวอร์ stdio ด้วย executable uvx, อาร์กิวเมนต์ pubship และสภาพแวดล้อมในเครื่องของคุณ สำหรับ client ที่ต้องมีการกำหนดค่าแบบชัดเจน:

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

การกำหนดค่า client ยังคงอยู่ในคอมพิวเตอร์ของคุณ ดู การตั้งค่า สำหรับโหมดการตรวจสอบสิทธิ์แบบอื่น, API ที่เปิดใช้งาน, รายงาน และขอบเขตสิทธิ์

สามารถทำอะไรได้บ้าง?

Local API coverage

รายการที่ตรึงไว้มีคำจำกัดความของเมธอด 172 รายการ 170 รายการมีการนำไปใช้จริง หนึ่งเมธอดสำหรับการเก็บถาวรการสมัครสมาชิกไม่ได้รับการสนับสนุนโดย Google และการเข้าถึง voided-purchases ถูกปิดใช้งานโดยนโยบายของโครงการโดยเจตนา การดำเนินการที่ถูกปิดใช้งานไม่สามารถเรียกผ่านเครื่องมือในเครื่องหรือ self-host ได้

  • อ่านรีลีส รีวิว Android vitals และรายงานแบบกลุ่มตามขอบเขต
  • ตรวจสอบแคตตาล็อก การสมัครสมาชิก ผลิตภัณฑ์ และทรัพยากรบัญชีด้วยการให้สิทธิ์ข้อมูลที่ละเอียดอ่อนแยกต่างหาก
  • เตรียมและตรวจสอบการเขียนด้วยสิทธิ์แอป/เมธอดที่ชัดเจนและการดำเนินการแบบใช้ครั้งเดียว
  • จำกัดการถ่ายโอนไฟล์ในเครื่องและแยกการเผยแพร่ออกจาก staging สำหรับการแก้ไข

การอ่านเป็นค่าเริ่มต้น การเขียนเพิ่มเติมและการอ่านข้อมูลที่ละเอียดอ่อนต้องมีการกำหนดค่าอย่างชัดเจน ข้อความจากผู้ให้บริการเป็นข้อมูลที่ไม่น่าเชื่อถือ ข้อมูลที่ขาดหายไปไม่ใช่ศูนย์ การเปลี่ยนแปลงที่ส่งไม่จำเป็นต้องเผยแพร่จริง จำนวนการดำเนินการไม่ใช่การอ้างว่าได้รับการตรวจสอบสดจาก Google

สำรวจสัญญาและขอบเขต

การโฮสต์ด้วยตนเองสำหรับบัญชีของคุณเอง

pubship-server ยังคงการนำไปใช้ HTTP สำหรับโครงสร้างพื้นฐานที่คุณควบคุม มันปฏิเสธที่จะเริ่มทำงานโดยไม่มี PUBSHIP_SERVER_ALLOWED_EMAILS การเข้าสู่ระบบต้องใช้ Google ID token ที่ลงนามแล้ว อีเมลที่ตรวจสอบแล้วว่าตรงกันทุกตัวอักษร และการผูก nonce ก่อนที่จะจัดเก็บข้อมูลประจำตัวของ Google ใด ๆ การลบบัญชีออกจากรายการที่อนุญาตจะทำให้สิทธิ์ที่เก็บไว้เป็นโมฆะในการใช้งานครั้งถัดไป สิทธิ์เดิมที่ไม่มีการยืนยันตัวตนต้องเชื่อมต่อใหม่ การลงทะเบียนยังคงปิดอยู่จนกว่าผู้ดำเนินการจะเปิดใช้งานอย่างชัดเจน

ไม่มีบริการที่เชื่อมต่อกับ Google ที่ดำเนินการโดยโครงการ ดู การตัดสินใจแบบ local-first และ การตั้งค่า self-host

หมายเหตุรีลีส

PubShip 0.24.2 ปรับปรุงคำอธิบายเครื่องมือและคำแนะนำการอนุมัติ และตรวจสอบคำจำกัดความเดียวกันในซอร์สและแพ็กเกจที่ติดตั้ง ดู changelog สำหรับเวอร์ชันก่อนหน้า เวอร์ชันซอร์สอาจมาก่อนการเผยแพร่แพ็กเกจ

การพัฒนา

คุณภาพคำจำกัดความเครื่องมือ เอกสารการตรวจสอบแบบออฟไลน์ TDQS 1.2 ผลการค้นพบฮิวริสติกที่ตรวจสอบแล้ว และความครอบคลุมการถดถอยของสัญญา MCP การ lint แบบออฟไลน์ไม่ใช่เกรดที่ให้คะแนนโดยโมเดล

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 engines การทดสอบการรวมแบ็กอัปต้องใช้ age บันทึกการตรวจสอบแพลตฟอร์มที่ไม่พร้อมใช้งานอย่างตรงไปตรงมา ดู นโยบายการมีส่วนร่วม, กระบวนการรีลีส และ การรายงานความปลอดภัย

การใช้งานตามวัตถุประสงค์

PubShip ช่วยนักพัฒนาอัตโนมัติงานเผยแพร่ Google Play ของตนเอง มันทำงานบนคอมพิวเตอร์ของคุณหรือบนโครงสร้างพื้นฐานที่คุณควบคุม ด้วยข้อมูลประจำตัว Google และสิทธิ์ Play Console ของคุณเอง โครงการ PubShip ไม่ได้ให้บริการโฮสต์และไม่เคยได้รับข้อมูลประจำตัวของคุณ ใช้กับแอปและบัญชีนักพัฒนาที่คุณหรือองค์กรของคุณเป็นเจ้าของเท่านั้น และปฏิบัติตามข้อกำหนด Google Play Developer API ตามข้อกำหนดของ Google ตัวอย่าง PubShip ที่โฮสต์โดยผู้อื่นไม่ได้ให้บริการหรือรับรองโดยโครงการ PubShip

PubShip เป็นโครงการโอเพนซอร์สอิสระและไม่เกี่ยวข้องกับ รับรองโดย หรือสนับสนุนโดย 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

เครื่องหมายการค้า · ประกาศบุคคลที่สาม · เว็บไซต์