PGYER

Serveur MCP PGYER

English | 中文

Serveur MCP (Model Context Protocol) pour 蒲公英 (PGYER). Téléchargez directement des packages d'installation Android (.apk), iOS (.ipa) et HarmonyOS (.hap) depuis des clients IA tels que Claude, Cursor, VS Code, Codex, consultez les applications et les versions historiques, et modifiez les paramètres des applications.

Depuis la version 2.0, ce package n'est qu'un lanceur : le serveur lui-même est fourni par l'outil en ligne de commande 蒲公英 @pgyer/cli (pgyer mcp), et les outils et le comportement des deux sont identiques. La configuration npx -y pgyer-mcp-server existante n'a pas besoin d'être modifiée.

Préparation

• Node.js 20.19 ou version ultérieure
• Clé API 蒲公英 : à obtenir sur la page d'informations API

Le serveur lit en priorité la variable d'environnement PGYER_API_KEY ; si elle n'est pas définie, il utilise les identifiants enregistrés localement par pgyer auth login.

Configuration

Claude Code

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

Claude Desktop

Modifiez claude_desktop_config.json (Paramètres → Développeur → Modifier la configuration) :

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

Cursor

Ajoutez dans ~/.cursor/mcp.json (global) ou dans le fichier .cursor/mcp.json du projet :

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

VS Code

Ajout en un clic :

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

Ou ajoutez dans le fichier .vscode/mcp.json du projet (la clé API est demandée au démarrage et n'est pas écrite dans le fichier) :

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

Ou modifiez ~/.codex/config.toml. Le délai d'expiration par défaut des outils de Codex est de 60 secondes ; augmentez-le lors du téléchargement de packages d'installation volumineux :

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

Si @pgyer/cli est installé globalement et que pgyer auth login a déjà été exécuté, vous pouvez également remplacer la commande par pgyer mcp et omettre PGYER_API_KEY.

Outils

Outil	Fonction	Lecture seule	Écrase l'état existant
upload_app	Télécharge un .apk/.ipa/.hap et attend la fin du traitement par 蒲公英, puis renvoie l'adresse de la page de téléchargement, le QR code, le numéro de version, etc. ; prend en charge le mode d'installation, le mot de passe d'installation, les notes de mise à jour, la présentation de l'application, la durée de validité de l'installation, les liens courts de canal, le téléchargement à l'étranger/en Chine et le délai d'expiration du traitement ; envoie la progression du téléchargement et du traitement lorsque le client fournit un progressToken	Non	Non
get_upload_status	Interroge le résultat du traitement d'un téléchargement par buildKey (à utiliser après un délai d'expiration du traitement de upload_app), avec possibilité de définir un temps d'attente	Oui	Non
list_apps	Liste par pagination les applications du compte et leur dernière version	Oui	Non
get_app	Interroge les détails d'une application par appKey ou lien court (ou adresse complète de la page de téléchargement), avec possibilité de spécifier une version historique	Oui	Non
list_versions	Liste par pagination les versions historiques par appKey ou lien court	Oui	Non
set_latest_version	Définit ou annule le marqueur « dernière version » d'une version donnée	Non	Oui
update_app_settings	Modifie le lien court, le mode d'installation et le mot de passe, la durée de validité de l'installation, la langue de la page de téléchargement, la source du numéro de version, la synchronisation automatique et l'affichage du copyright ; les paramètres non spécifiés restent inchangés, prend en charge dryRun	Non	Oui

• Le téléchargement n'envoie que les paramètres que vous spécifiez ; les paramètres non spécifiés conservent les valeurs actuelles de l'application
• Aucun outil de suppression d'application ou de version n'est fourni, et le mot de passe d'installation n'est jamais renvoyé
• Si le domaine principal www.pgyer.com est inaccessible, bascule automatiquement vers www.xcxwo.com, www.pgyerapp.com
• La clé API n'est envoyée que dans le corps des requêtes HTTPS et n'apparaît jamais dans l'URL

Mise à niveau depuis la version 1.x

Les noms d'outils de la version 2.0 passent en snake_case et de nouveaux outils ont été ajoutés. Si vos prompts ou la liste blanche d'outils de votre client utilisent les anciens noms, modifiez-les en conséquence :

1.x	2.0
upload-app	upload_app (ajout de tous les paramètres de téléchargement et des notifications de progression)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (paramètre shortcut)

Les résultats renvoyés par les outils sont également devenus des données structurées et mises en forme, et ne renvoient plus la réponse brute de l'API. La version 1.x plaçait la clé API dans l'URL d'interrogation du résultat de téléchargement ; ce problème est corrigé dans la version 2.0.

Docker

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

Développement et publication

Le code du serveur se trouve dans src/mcp/ du dépôt PGYER/pgyer-cli ; veuillez soumettre les problèmes et suggestions à ce dépôt. Ce dépôt ne contient que le lanceur, les métadonnées du registre MCP (server.json) et la documentation. Les étapes de publication sont décrites dans RELEASING.md.

Licence

MIT