PGYER

Server MCP PGYER

English | 中文

Server MCP (Model Context Protocol) untuk 蒲公英（PGYER）. Unggah paket instalasi Android (.apk), iOS (.ipa), dan HarmonyOS (.hap) langsung dari klien AI seperti Claude, Cursor, VS Code, dan Codex, cari aplikasi dan versi riwayat, serta ubah pengaturan aplikasi.

Mulai versi 2.0, paket ini hanyalah peluncur: server itu sendiri disediakan oleh alat baris perintah 蒲公英 @pgyer/cli (pgyer mcp), dan alat serta perilaku keduanya sepenuhnya sama. Konfigurasi npx -y pgyer-mcp-server yang sudah ada tidak perlu diubah.

Persiapan

• Node.js 20.19 atau lebih baru
• API Key 蒲公英: dapatkan di halaman informasi API

Server memprioritaskan pembacaan variabel lingkungan PGYER_API_KEY; jika tidak diatur, server menggunakan kredensial yang disimpan secara lokal oleh pgyer auth login.

Konfigurasi

Claude Code

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

Claude Desktop

Edit claude_desktop_config.json (Pengaturan → Pengembang → Edit konfigurasi):

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

Cursor

Tambahkan di ~/.cursor/mcp.json (global) atau .cursor/mcp.json di dalam proyek:

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

VS Code

Tambahkan dengan satu klik:

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

Atau tambahkan di .vscode/mcp.json proyek (akan meminta API Key saat mulai, tidak ditulis ke file):

{
  "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

Atau edit ~/.codex/config.toml. Batas waktu alat bawaan Codex adalah 60 detik; perbesar nilainya saat mengunggah paket instalasi yang besar:

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

Jika @pgyer/cli sudah terpasang secara global dan pgyer auth login sudah dijalankan, Anda juga dapat mengganti perintah menjadi pgyer mcp dan menghilangkan PGYER_API_KEY.

Alat

Alat	Fungsi	Hanya baca	Menimpa status yang ada
upload_app	Mengunggah .apk/.ipa/.hap dan menunggu 蒲公英 selesai memproses, mengembalikan alamat halaman unduhan, kode QR, nomor versi, dll.; mendukung metode instalasi, kata sandi instalasi, catatan pembaruan, deskripsi aplikasi, masa berlaku instalasi, tautan pendek saluran, unggah luar negeri/dalam negeri, dan batas waktu pemrosesan; mengirim progres unggah dan pemrosesan saat klien menyediakan progressToken	Tidak	Tidak
get_upload_status	Mencari hasil pemrosesan unggahan berdasarkan buildKey (digunakan setelah upload_app mengalami batas waktu pemrosesan), dapat mengatur waktu tunggu	Ya	Tidak
list_apps	Menampilkan daftar aplikasi dalam akun beserta versi terbarunya secara berpaginasi	Ya	Tidak
get_app	Mencari detail aplikasi berdasarkan appKey atau tautan pendek (bisa juga alamat halaman unduhan lengkap), dapat menentukan versi riwayat	Ya	Tidak
list_versions	Menampilkan daftar versi riwayat secara berpaginasi berdasarkan appKey atau tautan pendek	Ya	Tidak
set_latest_version	Mengatur atau membatalkan penanda "versi terbaru" pada suatu versi	Tidak	Ya
update_app_settings	Mengubah tautan pendek, metode dan kata sandi instalasi, masa berlaku instalasi, bahasa halaman unduhan, sumber nomor versi, sinkronisasi otomatis, dan tampilan hak cipta; pengaturan yang tidak ditentukan tetap tidak berubah, mendukung dryRun	Tidak	Ya

• Unggahan hanya mengirim pengaturan yang Anda tentukan; pengaturan yang tidak ditentukan tetap menggunakan nilai saat ini dari aplikasi
• Tidak tersedia alat untuk menghapus aplikasi atau versi, dan kata sandi instalasi tidak akan dikembalikan
• Jika domain utama www.pgyer.com tidak dapat diakses, secara otomatis beralih ke www.xcxwo.com, www.pgyerapp.com
• API Key hanya dikirim dalam isi permintaan HTTPS, tidak akan muncul di URL

Peningkatan dari 1.x

Nama alat di 2.0 diubah menjadi snake_case dan ditambahkan alat baru. Jika prompt atau daftar putih alat klien Anda menggunakan nama lama, silakan ubah sesuai:

1.x	2.0
upload-app	upload_app (menambahkan semua pengaturan unggahan dan notifikasi progres)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (parameter shortcut)

Hasil kembalian alat juga diubah menjadi data terstruktur yang telah dirapikan, tidak lagi mengembalikan respons API apa adanya. 1.x menempatkan API Key di URL untuk mencari hasil unggahan, dan 2.0 telah memperbaikinya.

Docker

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

Pengembangan dan rilis

Kode server berada di src/mcp/ dalam PGYER/pgyer-cli; silakan ajukan masalah dan saran ke repositori tersebut. Repositori ini hanya berisi peluncur, metadata MCP Registry (server.json), dan dokumentasi. Langkah rilis lihat RELEASING.md.

Lisensi

MIT