SnapDeploy MCP

официальный

Развертывание и управление приложениями SnapDeploy (Docker-контейнеры на AWS) из Claude Code, Cursor, Codex или Gemini CLI: сборки, логи, переменные окружения, дополнения, домены.

GitHubПопробовать этот MCPСпонсировано

Что можно делать с SnapDeploy MCP?

  • Deploy a GitHub repository — Попросите вашего ассистента развернуть репозиторий в SnapDeploy и получить живую ссылку через инструмент deploy.
  • Manage environment variables — Поручите ассистенту задать или проверить переменные окружения для контейнера, со значениями, скрытыми как (set).
  • Monitor deployment status — Запросите статус в реальном времени, логи или историю развертываний для любого контейнера SnapDeploy.
  • Control container lifecycle — Запускайте, останавливайте или пробуждайте контейнер по требованию, не покидая интерфейс чата.
  • Provision resources — Создавайте управляемые базы данных или назначайте пользовательские домены для ваших развертываний прямо из разговора.

Документация

@snapdeploy/mcp

Развертывайте и управляйте контейнерами SnapDeploy прямо из вашего ИИ-ассистента — Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI или любого клиента, который поддерживает Model Context Protocol через stdio.

Скажите "разверни этот репозиторий на SnapDeploy" и получите живую ссылку в ответ. Сборки, логи, переменные окружения, управляемые базы данных и пользовательские домены — не выходя из чата.

Настройка

  1. Войдите на snapdeploy.dev, откройте API Keys и создайте токен с областью deploy (страница сгенерирует фрагменты ниже с уже заполненным токеном).
  2. Добавьте сервер в ваш клиент:

Claude Code

claude mcp add --scope user snapdeploy -e SNAPDEPLOY_API_KEY=sd_pat_your_token -- npx -y @snapdeploy/mcp

Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Gemini CLI (~/.gemini/settings.json), Claude Desktop и другие клиенты с JSON-конфигурацией:

{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": ["-y", "@snapdeploy/mcp"],
      "env": { "SNAPDEPLOY_API_KEY": "sd_pat_your_token" }
    }
  }
}

Codex CLI (~/.codex/config.toml):

[mcp_servers.snapdeploy]
command = "npx"
args = ["-y", "@snapdeploy/mcp"]
env = { SNAPDEPLOY_API_KEY = "sd_pat_your_token" }

Плагин Claude Code (токен хранится в защищенном хранилище вместо файла конфигурации):

/plugin marketplace add AAR-Labs/snapdeploy-mcp
/plugin install snapdeploy@snapdeploy

Перезапустите сессию; появятся инструменты snapdeploy. Ваш репозиторий должен быть на GitHub, и GitHub должен быть один раз подключен к SnapDeploy (коннектор вернет ссылку, если это не так).

Инструменты

ОбластьИнструменты
readlist_apps get_status get_logs get_deployments check_quota list_repos detect_env_vars
deploydeploy set_env start_container stop_container wake_container
managecreate_database add_domain assign_always_on

Области вложены (read ⊂ deploy ⊂ manage); сервер проверяет их перед запуском любого инструмента. Инструмента удаления нет, и сервер отклоняет удаления, отмены подписок и смену паролей для любого токена — для этого нужен человек, вошедший в панель управления или мобильное приложение.

Модель безопасности

  • Ничего деструктивного, никогда. Даже агент, который переходит к прямому вызову API с тем же токеном, получит 403 INTERACTIVE_SESSION_REQUIRED.
  • Секреты никогда не попадают к модели. Значения переменных окружения возвращаются как (set), а учетные данные маскируются — на сервере, а не только в этом коннекторе.
  • Ограниченные, истекающие, отзываемые токены с собственным лимитом запросов. Отзовите токен на странице API Keys, и каждый запрос с этого момента будет возвращать 401.
  • Безопасные для повтора развертывания. Идентичные запросы в течение десяти минут возвращают исходное развертывание вместо запуска новой сборки.
  • Лимиты плана передаются, но не повторяются. Ответы 402/429 содержат собственное сообщение SnapDeploy и ссылку на апгрейд, а ассистенту сообщается не повторять запрос.

Переменные окружения

ПеременнаяОбязательнаяЗначение
SNAPDEPLOY_API_KEYдаОграниченный токен (sd_pat_…) или устаревший API-ключ
SNAPDEPLOY_READ_ONLYнет1 открывает только инструменты чтения
SNAPDEPLOY_BASE_URLнетПо умолчанию https://snapdeploy.dev

Ссылки

MIT © AAR Labs