PGYER

PGYER MCP Server

English | 中文

เซิร์ฟเวอร์ MCP (Model Context Protocol) ของ蒲公英 (PGYER) อัปโหลดแพ็กเกจติดตั้ง Android (.apk), iOS (.ipa) และ HarmonyOS (.hap) ได้โดยตรงจากไคลเอนต์ AI เช่น Claude, Cursor, VS Code, Codex พร้อมทั้งค้นหาแอปและเวอร์ชันย้อนหลัง และแก้ไขการตั้งค่าแอป

ตั้งแต่เวอร์ชัน 2.0 เป็นต้นไป แพ็กเกจนี้เป็นเพียงตัวเรียกใช้งานเท่านั้น: ตัวเซิร์ฟเวอร์เองให้บริการโดยเครื่องมือบรรทัดคำสั่งของ蒲公英 @pgyer/cli (pgyer mcp) โดยเครื่องมือและพฤติกรรมของทั้งสองเหมือนกันทุกประการ การกำหนดค่า npx -y pgyer-mcp-server เดิมไม่จำเป็นต้องแก้ไข

การเตรียมพร้อม

• Node.js 20.19 หรือสูงกว่า
• API Key ของ蒲公英: รับได้ที่ หน้าข้อมูล API

เซิร์ฟเวอร์จะอ่านตัวแปรสภาพแวดล้อม PGYER_API_KEY ก่อน; หากไม่ได้ตั้งค่าไว้ จะใช้ข้อมูลรับรองที่บันทึกไว้ในเครื่องซึ่งจัดเก็บโดย pgyer auth login

การกำหนดค่า

Claude Code

claude mcp add pgyer --env PGYER_API_KEY=<your_pgyer_api_key> -- npx -y pgyer-mcp-server

Claude Desktop

แก้ไข claude_desktop_config.json (การตั้งค่า → นักพัฒนา → แก้ไขการกำหนดค่า):

{
  "mcpServers": {
    "pgyer": {
      "command": "npx",
      "args": ["-y", "pgyer-mcp-server"],
      "env": { "PGYER_API_KEY": "<your_pgyer_api_key>" }
    }
  }
}

Cursor

เพิ่มใน ~/.cursor/mcp.json (ส่วนกลาง) หรือ .cursor/mcp.json ภายในโปรเจกต์:

{
  "mcpServers": {
    "pgyer": {
      "command": "npx",
      "args": ["-y", "pgyer-mcp-server"],
      "env": { "PGYER_API_KEY": "<your_pgyer_api_key>" }
    }
  }
}

VS Code

เพิ่มได้ในคลิกเดียว:

code --add-mcp '{"name":"pgyer","command":"npx","args":["-y","pgyer-mcp-server"],"env":{"PGYER_API_KEY":"<your_pgyer_api_key>"}}'

หรือเพิ่มใน .vscode/mcp.json ของโปรเจกต์ (จะแจ้งให้ป้อน API Key เมื่อเริ่มทำงาน และจะไม่เขียนลงในไฟล์):

{
  "inputs": [
    { "type": "promptString", "id": "pgyer-api-key", "description": "PGYER API Key", "password": true }
  ],
  "servers": {
    "pgyer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pgyer-mcp-server"],
      "env": { "PGYER_API_KEY": "${input:pgyer-api-key}" }
    }
  }
}

Codex

codex mcp add pgyer --env PGYER_API_KEY=<your_pgyer_api_key> -- npx -y pgyer-mcp-server

หรือแก้ไข ~/.codex/config.toml โดยค่าเริ่มต้น Timeout ของเครื่องมือใน Codex คือ 60 วินาที หากอัปโหลดแพ็กเกจติดตั้งขนาดใหญ่ โปรดเพิ่มค่านี้:

[mcp_servers.pgyer]
command = "npx"
args = ["-y", "pgyer-mcp-server"]
env = { PGYER_API_KEY = "<your_pgyer_api_key>" }
tool_timeout_sec = 900

หากติดตั้ง @pgyer/cli แบบส่วนกลางและเคยรัน pgyer auth login แล้ว สามารถเปลี่ยนคำสั่งเป็น pgyer mcp และละเว้น PGYER_API_KEY ได้

เครื่องมือ

เครื่องมือ	หน้าที่	อ่านอย่างเดียว	เขียนทับสถานะที่มีอยู่
upload_app	อัปโหลด .apk/.ipa/.hap และรอให้蒲公英ประมวลผลเสร็จ ส่งคืนที่อยู่หน้าดาวน์โหลด คิวอาร์โค้ด หมายเลขเวอร์ชัน ฯลฯ รองรับวิธีการติดตั้ง รหัสผ่านการติดตั้ง คำอธิบายการอัปเดต คำแนะนำแอป ระยะเวลาการติดตั้งลิงก์สั้นตามช่องทาง การอัปโหลดต่างประเทศ/ในประเทศ และ Timeout การประมวลผล; ส่งความคืบหน้าการอัปโหลดและการประมวลผลเมื่อไคลเอนต์มี progressToken	ไม่	ไม่
get_upload_status	ค้นหาผลลัพธ์การประมวลผลของการอัปโหลดตาม buildKey (ใช้เมื่อ upload_app ประมวลผลหมดเวลา) สามารถกำหนดเวลารอได้	ใช่	ไม่
list_apps	แสดงรายการแอปและเวอร์ชันล่าสุดภายใต้บัญชีแบบแบ่งหน้า	ใช่	ไม่
get_app	ค้นหารายละเอียดแอปตาม appKey หรือลิงก์สั้น (หรือที่อยู่หน้าดาวน์โหลดแบบเต็ม) สามารถระบุเวอร์ชันย้อนหลังได้	ใช่	ไม่
list_versions	แสดงรายการเวอร์ชันย้อนหลังตาม appKey หรือลิงก์สั้นแบบแบ่งหน้า	ใช่	ไม่
set_latest_version	ตั้งค่าหรือยกเลิกเครื่องหมาย "เวอร์ชันล่าสุด" ของเวอร์ชันหนึ่ง	ไม่	ใช่
update_app_settings	แก้ไขลิงก์สั้น วิธีการติดตั้งและรหัสผ่าน ระยะเวลาการติดตั้ง ภาษาของหน้าดาวน์โหลด แหล่งที่มาของหมายเลขเวอร์ชัน การซิงค์อัตโนมัติ และการแสดงลิขสิทธิ์; การตั้งค่าที่ไม่ได้ระบุจะคงเดิม รองรับ dryRun	ไม่	ใช่

• การอัปโหลดจะส่งเฉพาะการตั้งค่าที่คุณระบุเท่านั้น การตั้งค่าที่ไม่ได้ระบุจะคงค่าปัจจุบันของแอปไว้
• ไม่มีเครื่องมือสำหรับลบแอปหรือเวอร์ชัน และจะไม่ส่งคืนรหัสผ่านการติดตั้ง
• เมื่อไม่สามารถเข้าถึงโดเมนหลัก www.pgyer.com ได้ จะเปลี่ยนไปใช้ www.xcxwo.com, www.pgyerapp.com โดยอัตโนมัติ
• API Key จะถูกส่งเฉพาะในเนื้อหาคำขอ HTTPS เท่านั้น และจะไม่ปรากฏใน URL

การอัปเกรดจาก 1.x

ชื่อเครื่องมือใน 2.0 เปลี่ยนเป็น snake_case และมีเครื่องมือใหม่เพิ่มขึ้น หากพรอมต์หรือรายการอนุญาตเครื่องมือของไคลเอนต์ของคุณใช้ชื่อเดิม โปรดแก้ไขให้สอดคล้อง:

1.x	2.0
upload-app	upload_app (เพิ่มการตั้งค่าการอัปโหลดทั้งหมดและการแจ้งเตือนความคืบหน้า)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (พารามิเตอร์ shortcut)

ผลลัพธ์ที่ส่งคืนจากเครื่องมือยังเปลี่ยนเป็นข้อมูลที่มีโครงสร้างและจัดระเบียบแล้ว ไม่ได้ส่งคืนการตอบสนองของ API ตามเดิมอีกต่อไป ใน 1.x มีการใส่ API Key ไว้ใน URL สำหรับค้นหาผลลัพธ์การอัปโหลด ซึ่งได้รับการแก้ไขแล้วใน 2.0

Docker

docker build -t pgyer-mcp-server .
docker run -i --rm -e PGYER_API_KEY=<your_pgyer_api_key> pgyer-mcp-server

การพัฒนาและการเผยแพร่

โค้ดของเซิร์ฟเวอร์อยู่ใน src/mcp/ ของ PGYER/pgyer-cli หากมีปัญหาและข้อเสนอแนะ โปรดส่งไปยังที่เก็บนั้น ที่เก็บนี้มีเพียงตัวเรียกใช้งาน เมทาดาทาของ MCP Registry (server.json) และเอกสารเท่านั้น ขั้นตอนการเผยแพร่ดูได้ที่ RELEASING.md

สัญญาอนุญาต

MIT