PGYER

PGYER MCP Server

English | 中文

MCP-сервер (Model Context Protocol) для 蒲公英 (PGYER). Загружайте установочные пакеты Android (.apk), iOS (.ipa) и HarmonyOS (.hap), просматривайте приложения и историю версий, изменяйте настройки приложений прямо в AI-клиентах, таких как Claude, Cursor, VS Code и Codex.

Начиная с версии 2.0, этот пакет является лишь лаунчером: сам сервер предоставляется инструментом командной строки 蒲公英 @pgyer/cli (pgyer mcp), и инструменты и поведение у них полностью совпадают. Существующую конфигурацию npx -y pgyer-mcp-server изменять не нужно.

Подготовка

• Node.js 20.19 или выше
• API Key 蒲公英: получите на странице с информацией об API

Сервер в первую очередь читает переменную окружения PGYER_API_KEY; если она не задана, используются учётные данные, сохранённые локально в pgyer auth login.

Настройка

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 (Настройки → Разработчик → Изменить конфигурацию):

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

Cursor

Добавьте в ~/.cursor/mcp.json (глобально) или в .cursor/mcp.json внутри проекта:

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

VS Code

Добавление в один клик:

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

Или добавьте в .vscode/mcp.json проекта (при запуске будет предложено ввести API Key, он не будет записан в файл):

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

Или отредактируйте ~/.codex/config.toml. По умолчанию тайм-аут инструментов в Codex составляет 60 секунд; при загрузке больших установочных пакетов увеличьте его:

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

Если @pgyer/cli установлен глобально и была выполнена команда pgyer auth login, можно заменить команду на pgyer mcp и опустить PGYER_API_KEY.

Инструменты

Инструмент	Назначение	Только чтение	Перезаписывает существующее состояние
upload_app	Загружает .apk/.ipa/.hap и ожидает завершения обработки 蒲公英, возвращает адрес страницы загрузки, QR-код, номер версии и т. д.; поддерживает способ установки, пароль установки, описание обновления, описание приложения, срок действия установки, короткую ссылку канала, зарубежную/внутреннюю загрузку и тайм-аут обработки; при наличии progressToken у клиента отправляет прогресс загрузки и обработки	Нет	Нет
get_upload_status	Запрашивает результат обработки загрузки по buildKey (используется после тайм-аута обработки upload_app), можно задать время ожидания	Да	Нет
list_apps	Постранично выводит список приложений аккаунта и их последние версии	Да	Нет
get_app	Запрашивает сведения о приложении по appKey или короткой ссылке (также можно указать полный адрес страницы загрузки), можно указать историческую версию	Да	Нет
list_versions	Постранично выводит историю версий по appKey или короткой ссылке	Да	Нет
set_latest_version	Устанавливает или снимает отметку «последняя версия» у определённой версии	Нет	Да
update_app_settings	Изменяет короткую ссылку, способ установки и пароль, срок действия установки, язык страницы загрузки, источник номера версии, автосинхронизацию и отображение копирайта; неуказанные настройки остаются без изменений, поддерживается dryRun	Нет	Да

• При загрузке отправляются только указанные вами настройки, неуказанные настройки сохраняют текущие значения приложения
• Инструментов для удаления приложений или версий не предусмотрено, пароль установки также не возвращается
• Если основной домен www.pgyer.com недоступен, автоматически используются www.xcxwo.com, www.pgyerapp.com
• API Key передаётся только в теле HTTPS-запроса и не появляется в URL

Обновление с 1.x

В версии 2.0 имена инструментов изменены на snake_case и добавлены новые инструменты. Если в ваших промптах или белых списках инструментов клиента указаны старые имена, измените их соответствующим образом:

1.x	2.0
upload-app	upload_app (добавлены все настройки загрузки и уведомления о прогрессе)
list-my-apps	list_apps
get-app-info-by-shortcut	get_app (параметр shortcut)

Результаты инструментов также изменены на структурированные данные после обработки и больше не возвращают ответ API как есть. В версии 1.x API Key помещался в URL запроса результата загрузки, в версии 2.0 это исправлено.

Docker

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

Разработка и публикация

Код сервера находится в src/mcp/ репозитория PGYER/pgyer-cli; сообщайте о проблемах и предложениях в этот репозиторий. Данный репозиторий содержит только лаунчер, метаданные MCP Registry (server.json) и документацию. Шаги публикации см. в RELEASING.md.

Лицензия

MIT