PGYER

Servidor MCP do PGYER

English | 中文

Servidor MCP (Model Context Protocol) do 蒲公英 (PGYER). Faça upload diretamente de pacotes de instalação Android (.apk), iOS (.ipa) e HarmonyOS (.hap) em clientes de IA como Claude, Cursor, VS Code e Codex, consulte aplicativos e versões anteriores e altere as configurações do aplicativo.

A partir da versão 2.0, este pacote é apenas um inicializador: o servidor em si é fornecido pela ferramenta de linha de comando do 蒲公英 @pgyer/cli (pgyer mcp), e as ferramentas e o comportamento de ambos são idênticos. As configurações existentes de npx -y pgyer-mcp-server não precisam ser alteradas.

Preparação

• Node.js 20.19 ou superior
• Chave de API do 蒲公英: obtenha em Página de informações da API

O servidor lê prioritariamente a variável de ambiente PGYER_API_KEY; quando não definida, usa as credenciais salvas localmente por pgyer auth login.

Configuração

Claude Code

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

Claude Desktop

Edite claude_desktop_config.json (Configurações → Desenvolvedor → Editar configuração):

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

Cursor

Adicione em ~/.cursor/mcp.json (global) ou no .cursor/mcp.json dentro do projeto:

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

VS Code

Adição com um clique:

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

Ou adicione no .vscode/mcp.json do projeto (solicita a chave de API na inicialização e não a grava no arquivo):

{
  "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 edite ~/.codex/config.toml. O tempo limite padrão das ferramentas do Codex é de 60 segundos; aumente-o ao enviar pacotes de instalação grandes:

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

Se você já instalou @pgyer/cli globalmente e executou pgyer auth login, também pode trocar o comando por pgyer mcp e omitir PGYER_API_KEY.

Ferramentas

Ferramenta	Função	Somente leitura	Sobrescreve estado existente
upload_app	Envia .apk/.ipa/.hap e aguarda a conclusão do processamento pelo 蒲公英, retornando o endereço da página de download, QR code, número da versão etc.; suporta modo de instalação, senha de instalação, notas de atualização, descrição do aplicativo, validade da instalação, link curto de canal, upload internacional/nacional e tempo limite de processamento; envia progresso de upload e processamento quando o cliente fornece progressToken	Não	Não
get_upload_status	Consulta o resultado do processamento de um upload por buildKey (use após o tempo limite de processamento de upload_app), com tempo de espera configurável	Sim	Não
list_apps	Lista paginada dos aplicativos da conta e suas versões mais recentes	Sim	Não
get_app	Consulta os detalhes do aplicativo por appKey ou link curto (também pode ser o endereço completo da página de download), com opção de especificar uma versão anterior	Sim	Não
list_versions	Lista paginada das versões anteriores por appKey ou link curto	Sim	Não
set_latest_version	Define ou remove a marcação de "versão mais recente" de uma versão	Não	Sim
update_app_settings	Altera link curto, modo de instalação e senha, validade da instalação, idioma da página de download, origem do número da versão, sincronização automática e exibição de direitos autorais; configurações não especificadas permanecem inalteradas, com suporte a dryRun	Não	Sim

• O upload envia apenas as configurações que você especificar; as não especificadas mantêm os valores atuais do aplicativo
• Não há ferramentas para excluir aplicativos ou versões, e a senha de instalação não é retornada
• Quando o domínio principal www.pgyer.com estiver inacessível, usa automaticamente www.xcxwo.com e www.pgyerapp.com
• A chave de API é enviada apenas no corpo de requisições HTTPS e nunca aparece na URL

Atualização a partir da 1.x

Na versão 2.0, os nomes das ferramentas passaram para snake_case e novas ferramentas foram adicionadas. Se seus prompts ou a lista de permissões de ferramentas do cliente usam os nomes antigos, ajuste-os:

1.x	2.0
upload-app	upload_app (adiciona todas as configurações de upload e notificações de progresso)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (parâmetro shortcut)

Os resultados retornados pelas ferramentas também passaram a ser dados estruturados organizados, em vez de retornar a resposta da API como está. A versão 1.x colocava a chave de API na URL de consulta do resultado do upload; isso foi corrigido na 2.0.

Docker

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

Desenvolvimento e publicação

O código do servidor está em src/mcp/ no repositório PGYER/pgyer-cli; envie problemas e sugestões de melhoria para esse repositório. Este repositório contém apenas o inicializador, os metadados do MCP Registry (server.json) e a documentação. Consulte RELEASING.md para as etapas de publicação.

Licença

MIT