PGYER

Servidor MCP de PGYER

English | 中文

Servidor MCP (Model Context Protocol) de 蒲公英 (PGYER). Sube directamente paquetes de instalación de Android (.apk), iOS (.ipa) y HarmonyOS (.hap) desde clientes de IA como Claude, Cursor, VS Code y Codex, consulta aplicaciones y versiones históricas, y modifica la configuración de las aplicaciones.

A partir de la versión 2.0, este paquete es solo un lanzador: el servidor lo proporciona la herramienta de línea de comandos de 蒲公英 @pgyer/cli (pgyer mcp), y ambas tienen las mismas herramientas y el mismo comportamiento. La configuración existente de npx -y pgyer-mcp-server no necesita modificarse.

Preparación

• Node.js 20.19 o superior
• Clave API de 蒲公英: obtenla en la página de información de API

El servidor lee primero la variable de entorno PGYER_API_KEY; si no está definida, usa las credenciales guardadas localmente por pgyer auth login.

Configuración

Claude Code

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

Claude Desktop

Edita claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

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

Cursor

Añade lo siguiente en ~/.cursor/mcp.json (global) o en el .cursor/mcp.json del proyecto:

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

VS Code

Añadir con un clic:

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

O añade lo siguiente en el .vscode/mcp.json del proyecto (al iniciar se solicita la clave API, no se escribe en el archivo):

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

O edita ~/.codex/config.toml. El tiempo de espera predeterminado de las herramientas de Codex es de 60 segundos; auméntalo al subir paquetes de instalación grandes:

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

Si ya instalaste @pgyer/cli globalmente y ejecutaste pgyer auth login, también puedes cambiar el comando por pgyer mcp y omitir PGYER_API_KEY.

Herramientas

Herramienta	Función	Solo lectura	Sobrescribe el estado existente
upload_app	Sube .apk/.ipa/.hap y espera a que 蒲公英 termine de procesarlo; devuelve la dirección de la página de descarga, el código QR, el número de versión, etc.; admite método de instalación, contraseña de instalación, notas de actualización, descripción de la aplicación, período de validez de la instalación, enlace corto de canal, carga nacional/internacional y tiempo de espera de procesamiento; envía el progreso de carga y procesamiento cuando el cliente proporciona progressToken	No	No
get_upload_status	Consulta el resultado del procesamiento de una carga por buildKey (se usa cuando upload_app agota el tiempo de espera), permite establecer el tiempo de espera	Sí	No
list_apps	Lista de forma paginada las aplicaciones de la cuenta y su versión más reciente	Sí	No
get_app	Consulta los detalles de una aplicación por appKey o enlace corto (también puede ser la dirección completa de la página de descarga), permite especificar una versión histórica	Sí	No
list_versions	Lista de forma paginada las versiones históricas por appKey o enlace corto	Sí	No
set_latest_version	Establece o cancela la marca de «versión más reciente» de una versión	No	Sí
update_app_settings	Modifica el enlace corto, el método y la contraseña de instalación, el período de validez de la instalación, el idioma de la página de descarga, el origen del número de versión, la sincronización automática y la visualización de derechos de autor; la configuración no especificada se mantiene sin cambios, admite dryRun	No	Sí

• La carga solo envía la configuración que especifiques; la configuración no especificada mantiene el valor actual de la aplicación
• No se proporcionan herramientas para eliminar aplicaciones o versiones, ni se devuelve la contraseña de instalación
• Si el dominio principal www.pgyer.com no es accesible, se cambia automáticamente a www.xcxwo.com, www.pgyerapp.com
• La clave API solo se envía en el cuerpo de solicitudes HTTPS, nunca aparece en la URL

Actualización desde 1.x

En 2.0 los nombres de las herramientas cambiaron a snake_case y se añadieron nuevas herramientas. Si tus prompts o la lista blanca de herramientas de tu cliente usan los nombres antiguos, modifícalos en consecuencia:

1.x	2.0
upload-app	upload_app (se añadieron todas las opciones de carga y las notificaciones de progreso)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (parámetro shortcut)

Los resultados devueltos por las herramientas también cambiaron a datos estructurados y organizados, en lugar de devolver la respuesta de la API tal cual. En 1.x la clave API se incluía en la URL de consulta del resultado de la carga; en 2.0 ya se corrigió.

Docker

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

Desarrollo y publicación

El código del servidor está en src/mcp/ de PGYER/pgyer-cli; envía problemas y mejoras a ese repositorio. Este repositorio solo contiene el lanzador, los metadatos de MCP Registry (server.json) y la documentación. Los pasos de publicación están en RELEASING.md.

Licencia

MIT