PGYER

PGYER MCP Server

English | 中文

蒲公英（PGYER）için MCP (Model Context Protocol) sunucusu. Claude, Cursor, VS Code, Codex gibi yapay zeka istemcilerinde Android (.apk), iOS (.ipa) ve HarmonyOS (.hap) kurulum paketlerini doğrudan yükleyin, uygulamaları ve geçmiş sürümleri sorgulayın, uygulama ayarlarını değiştirin.

2.0'dan itibaren bu paket yalnızca bir başlatıcıdır: sunucunun kendisi, PGYER komut satırı aracı @pgyer/cli (pgyer mcp) tarafından sağlanır; her ikisinin araçları ve davranışları tamamen aynıdır. Mevcut npx -y pgyer-mcp-server yapılandırmasının değiştirilmesi gerekmez.

Hazırlık

• Node.js 20.19 veya üzeri
• PGYER API Anahtarı: API bilgi sayfasından edinin

Sunucu öncelikle PGYER_API_KEY ortam değişkenini okur; ayarlanmamışsa, bu makinede pgyer auth login tarafından saklanan kimlik bilgilerini kullanır.

Yapılandırma

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 dosyasını düzenleyin (Ayarlar → Geliştirici → Yapılandırmayı düzenle):

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

Cursor

~/.cursor/mcp.json (genel) veya proje içindeki .cursor/mcp.json dosyasına ekleyin:

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

VS Code

Tek tıkla ekle:

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

Veya projenin .vscode/mcp.json dosyasına ekleyin (başlatma sırasında API Anahtarı istenir, dosyaya yazılmaz):

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

Veya ~/.codex/config.toml dosyasını düzenleyin. Codex'in varsayılan araç zaman aşımı 60 saniyedir; büyük kurulum paketleri yüklerken bunu artırın:

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

@pgyer/cli genel olarak yüklüyse ve pgyer auth login çalıştırıldıysa, komutu pgyer mcp olarak değiştirebilir ve PGYER_API_KEY öğesini atlayabilirsiniz.

Araçlar

Araç	İşlev	Salt okunur	Mevcut durumun üzerine yazar
upload_app	.apk/.ipa/.hap yükler ve PGYER işlemi tamamlayana kadar bekler; indirme sayfası adresi, QR kodu, sürüm numarası vb. döndürür; kurulum yöntemi, kurulum parolası, güncelleme notları, uygulama açıklaması, kurulum geçerlilik süresi, kanal kısa bağlantısı, yurt dışı/yurt içi yükleme ve işleme zaman aşımını destekler; istemci bir progressToken sağladığında yükleme ve işleme ilerlemesini gönderir	Hayır	Hayır
get_upload_status	buildKey ile bir yüklemenin işlem sonucunu sorgular (upload_app işlem zaman aşımından sonra kullanılır), bekleme süresi ayarlanabilir	Evet	Hayır
list_apps	Hesaptaki uygulamaları ve en son sürümlerini sayfalayarak listeler	Evet	Hayır
get_app	appKey veya kısa bağlantı (tam indirme sayfası adresi de olabilir) ile uygulama ayrıntılarını sorgular, geçmiş sürüm belirtilebilir	Evet	Hayır
list_versions	appKey veya kısa bağlantı ile geçmiş sürümleri sayfalayarak listeler	Evet	Hayır
set_latest_version	Belirli bir sürümün "en son sürüm" işaretini ayarlar veya kaldırır	Hayır	Evet
update_app_settings	Kısa bağlantıyı, kurulum yöntemini ve parolasını, kurulum geçerlilik süresini, indirme sayfası dilini, sürüm numarası kaynağını, otomatik eşitlemeyi ve telif hakkı gösterimini değiştirir; belirtilmeyen ayarlar değişmeden kalır, dryRun desteklenir	Hayır	Evet

• Yükleme yalnızca belirttiğiniz ayarları gönderir; belirtilmeyen ayarlar uygulamanın mevcut değerlerini korur
• Uygulama veya sürüm silme aracı sunulmaz ve kurulum parolası döndürülmez
• Ana alan adı www.pgyer.com erişilemediğinde otomatik olarak www.xcxwo.com, www.pgyerapp.com kullanılır
• API Anahtarı yalnızca HTTPS istek gövdesinde gönderilir, URL'de görünmez

1.x'ten yükseltme

2.0'da araç adları snake_case olarak değiştirildi ve yeni araçlar eklendi. İstemlerinizde veya istemcinizin araç izin listesinde eski adlar yazıyorsa, bunları buna göre değiştirin:

1.x	2.0
upload-app	upload_app (tüm yükleme ayarları ve ilerleme bildirimleri eklendi)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (parametre shortcut)

Araçların dönüş sonuçları da düzenlenmiş yapılandırılmış verilere dönüştürüldü; artık API yanıtı olduğu gibi döndürülmüyor. 1.x, API Anahtarını yükleme sonucu sorgulama URL'sine koyuyordu; 2.0'da bu düzeltildi.

Docker

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

Geliştirme ve yayınlama

Sunucu kodu PGYER/pgyer-cli deposunun src/mcp/ dizinindedir; sorunları ve iyileştirmeleri o depoya bildirin. Bu depo yalnızca başlatıcıyı, MCP Registry meta verilerini (server.json) ve belgeleri içerir. Yayınlama adımları için bkz. RELEASING.md.

Lisans

MIT