PubShip
ทางการเซิร์ฟเวอร์ MCP แบบโอเพนซอร์สสำหรับขั้นตอนการทำงานของนักพัฒนา Google Play ทำงานในเครื่องของคุณเองด้วยข้อมูลประจำตัวของคุณ
คุณทำอะไรได้บ้างด้วย PubShip MCP?
- ตรวจสอบข้อมูล Play releases และรีวิว — ขอให้ผู้ช่วยของคุณดึงข้อมูล release ล่าสุด รีวิวจากผู้ใช้ และ Android vitals สำหรับแอปของคุณ
- ตรวจสอบรายงานสรุปแบบแบ่งขอบเขต — ให้ผู้ช่วยของคุณดึงและสรุปรายงานแบบกลุ่มที่ครอบคลุมข้อมูลแคตตาล็อก การสมัครสมาชิก ผลิตภัณฑ์ และบัญชี
- เตรียมและจัดเตรียมการแก้ไข — ขอให้ผู้ช่วยของคุณร่างและตรวจสอบการเปลี่ยนแปลงรายการแอปหรือข้อมูลเมตา โดยมีการตรวจสอบสิทธิ์อย่างชัดเจนก่อนดำเนินการ
- ดำเนินการเขียนที่ได้รับอนุมัติแบบใช้ครั้งเดียว — สั่งให้ผู้ช่วยของคุณใช้การเปลี่ยนแปลงที่เตรียมไว้หนึ่งครั้ง โดยใช้สิทธิ์แอปและเมธอดที่คุณอนุญาตอย่างชัดเจน
- จัดการการโอนไฟล์ในเครื่อง — ขอการโอนไฟล์ที่มีขอบเขตจำกัดระหว่างเครื่องของคุณและ Play โดยแยกการเผยแพร่ออกจากการจัดเตรียมการแก้ไข
เอกสาร
PubShip
เวิร์กโฟลว์สำหรับนักพัฒนา Google Play จากคอมพิวเตอร์ของคุณเอง ตรวจสอบรีลีส ทำความเข้าใจรีวิวและรายงาน และเตรียมการเปลี่ยนแปลงที่ได้รับอนุญาตอย่างชัดเจนจาก MCP client ของคุณ
เริ่มต้นใช้งานในเครื่อง
ใช้ 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 ที่เปิดใช้งาน, รายงาน และขอบเขตสิทธิ์
สามารถทำอะไรได้บ้าง?
รายการที่ตรึงไว้มีคำจำกัดความของเมธอด 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