PGYER

PGYER MCP Server

English | 中文

Ein MCP-Server (Model Context Protocol) für Pgyer (PGYER). Lade Android- (.apk), iOS- (.ipa) und HarmonyOS- (.hap) Installationspakete direkt in KI-Clients wie Claude, Cursor, VS Code und Codex hoch, frage Apps und Versionsverläufe ab und ändere App-Einstellungen.

Seit 2.0 ist dieses Paket nur noch ein Launcher: Der Server selbst wird vom Pgyer-Kommandozeilentool @pgyer/cli (pgyer mcp) bereitgestellt, beide haben identische Tools und identisches Verhalten. Bestehende npx -y pgyer-mcp-server-Konfigurationen müssen nicht geändert werden.

Vorbereitung

• Node.js 20.19 oder höher
• Pgyer API Key: erhältlich auf der API-Infoseite

Der Server liest bevorzugt die Umgebungsvariable PGYER_API_KEY; ist sie nicht gesetzt, werden die lokal gespeicherten Zugangsdaten aus pgyer auth login verwendet.

Konfiguration

Claude Code

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

Claude Desktop

Bearbeite claude_desktop_config.json (Einstellungen → Entwickler → Konfiguration bearbeiten):

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

Cursor

Füge Folgendes in ~/.cursor/mcp.json (global) oder im projektinternen .cursor/mcp.json hinzu:

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

VS Code

Mit einem Klick hinzufügen:

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

Oder füge Folgendes im projektinternen .vscode/mcp.json hinzu (beim Start wird zur Eingabe des API Key aufgefordert, er wird nicht in die Datei geschrieben):

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

Oder bearbeite ~/.codex/config.toml. Das Standard-Tool-Timeout von Codex beträgt 60 Sekunden; erhöhe es beim Hochladen größerer Installationspakete:

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

Wenn @pgyer/cli global installiert und pgyer auth login ausgeführt wurde, kannst du den Befehl auch durch pgyer mcp ersetzen und PGYER_API_KEY weglassen.

Tools

Tool	Funktion	Schreibgeschützt	Überschreibt vorhandenen Status
upload_app	Lädt .apk/.ipa/.hap hoch und wartet, bis die Verarbeitung durch Pgyer abgeschlossen ist; gibt Downloadseiten-Adresse, QR-Code, Versionsnummer usw. zurück; unterstützt Installationsart, Installationspasswort, Update-Beschreibung, App-Beschreibung, Installationsgültigkeit, Kanal-Kurzlinks, Upload ins Ausland/Inland und Verarbeitungs-Timeout; sendet Upload- und Verarbeitungsfortschritt, wenn der Client ein progressToken bereitstellt	Nein	Nein
get_upload_status	Fragt das Verarbeitungsergebnis eines Uploads per buildKey ab (verwende dies nach einem Verarbeitungs-Timeout von upload_app); Wartezeit kann festgelegt werden	Ja	Nein
list_apps	Listet die Apps des Kontos samt ihrer neuesten Version seitenweise auf	Ja	Nein
get_app	Fragt App-Details per appKey oder Kurzlink ab (auch eine vollständige Downloadseiten-Adresse ist möglich); eine historische Version kann angegeben werden	Ja	Nein
list_versions	Listet historische Versionen per appKey oder Kurzlink seitenweise auf	Ja	Nein
set_latest_version	Setzt oder entfernt die Markierung „Neueste Version" für eine bestimmte Version	Nein	Ja
update_app_settings	Ändert Kurzlink, Installationsart und -passwort, Installationsgültigkeit, Sprache der Downloadseite, Quelle der Versionsnummer, automatische Synchronisierung und Copyright-Anzeige; nicht angegebene Einstellungen bleiben unverändert; unterstützt dryRun	Nein	Ja

• Beim Upload werden nur die von dir angegebenen Einstellungen gesendet; nicht angegebene Einstellungen behalten die aktuellen Werte der App bei
• Es gibt kein Tool zum Löschen von Apps oder Versionen, und das Installationspasswort wird nicht zurückgegeben
• Ist die Hauptdomain www.pgyer.com nicht erreichbar, wird automatisch auf www.xcxwo.com, www.pgyerapp.com ausgewichen
• Der API Key wird nur im HTTPS-Anfragekörper gesendet und erscheint nicht in der URL

Upgrade von 1.x

In 2.0 wurden die Tool-Namen auf snake_case umgestellt und neue Tools hinzugefügt. Wenn deine Prompts oder die Tool-Whitelist deines Clients die alten Namen verwenden, passe sie entsprechend an:

1.x	2.0
upload-app	upload_app (neue Upload-Einstellungen und Fortschrittsbenachrichtigungen)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (Parameter shortcut)

Auch die Rückgabewerte der Tools sind jetzt aufbereitete strukturierte Daten und keine unveränderten API-Antworten mehr. In 1.x wurde der API Key in der URL zur Abfrage des Upload-Ergebnisses mitgesendet; dies ist in 2.0 behoben.

Docker

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

Entwicklung und Veröffentlichung

Der Servercode befindet sich in src/mcp/ im Repository PGYER/pgyer-cli; Probleme und Verbesserungsvorschläge bitte dort einreichen. Dieses Repository enthält nur den Launcher, die MCP-Registry-Metadaten (server.json) und die Dokumentation. Die Veröffentlichungsschritte findest du in RELEASING.md.

Lizenz

MIT