SnapDeploy MCP

resmi

SnapDeploy uygulamalarını (AWS üzerinde Docker konteynerleri) Claude Code, Cursor, Codex veya Gemini CLI'den dağıtın ve yönetin: derlemeler, günlükler, ortam değişkenleri, eklentiler, alan adları.

GitHub

SnapDeploy MCP ile neler yapabilirsiniz?

  • GitHub'dan Dağıt — Bağlı bir GitHub deposunu dağıtmayı isteyin ve deploy ile canlı bir URL alın.
  • Ortam değişkenlerini yönet — Gizli değerleri ifşa etmeden, with ve set_env kullanarak bir uygulama için ortam değişkenlerini ayarlayın veya güncelleyin.
  • Dağıtımları izle — get_status, get_logs ve get_deployments ile dağıtım durumunu kontrol edin, günlükleri görüntüleyin ve son dağıtımları listeleyin.
  • Kapsayıcıları kontrol et — start_container, stop_container ve wake_container kullanarak bir kapsayıcıyı isteğe bağlı olarak başlatın, durdurun veya uyandırın.
  • Kaynakları sağla — create_database ve add_domain ile yönetilen bir veritabanı oluşturun veya bir uygulamaya özel bir alan adı ekleyin.

Dokümantasyon

@snapdeploy/mcp

Yapay zeka asistanınızdan SnapDeploy konteynerlerini dağıtın ve yönetin — Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI veya stdio üzerinden Model Context Protocol konuşan herhangi bir istemci.

"bu repoyu SnapDeploy'a dağıt" deyin ve canlı bir URL alın. Derlemeler, günlükler, ortam değişkenleri, yönetilen veritabanları ve özel alan adları — sohbetten çıkmadan.

Kurulum

  1. snapdeploy.dev adresinde oturum açın, API Anahtarları'nı açın ve deploy kapsamına sahip bir token oluşturun (sayfa aşağıdaki snippet'leri token'ınız zaten doldurulmuş olarak üretir).
  2. Sunucuyu istemcinize ekleyin:

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 ve JSON ile yapılandırılan diğer istemciler:

{
  "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 eklentisi (token bir yapılandırma dosyası yerine güvenli depolamada saklanır):

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

Oturumu yeniden başlatın; snapdeploy araçları görünür. Deponuz GitHub'da olmalı ve GitHub'ın SnapDeploy'a bir kez bağlanması gerekir (bağlayıcı bağlı değilse bağlantıyı döndürür).

Araçlar

KapsamAraçlar
readlist_apps get_status get_logs get_deployments check_quota list_repos detect_env_vars
deploydeploy deploy_image set_env start_container stop_container wake_container
managecreate_database add_domain assign_always_on

Kapsamlar iç içe geçer (read ⊂ deploy ⊂ manage); sunucu bunları herhangi bir araç çalışmadan önce uygular. Silme aracı yoktur ve sunucu her token için silme işlemlerini, abonelik iptallerini ve şifre değişikliklerini reddeder — bunlar için kontrol panelinde veya mobil uygulamada oturum açmış bir kişi gerekir.

Önceden oluşturulmuş görüntüler. deploy bağlı bir GitHub deposundan derler; görüntü aracı yoktur. Genel bir Docker görüntüsü çalıştırmak için kontrol panelini (Uygulamanızı Dağıtın → Docker Görüntüsü) veya POST /api/mobile/containers ile name, image, imageTag, port, ardından POST /api/mobile/containers/{containerId}/start kullanın. Görüntüler Docker Hub, ghcr.io, quay.io veya public.ecr.aws adreslerinden gelmeli, linux/amd64 veya linux/arm64 yayınlamalı ve SnapDeploy'un oluşturma zamanı ilke denetimini geçmelidir; bir 400 Security policy violation kesindir ve yeniden denenmemelidir. Tam kurallar: https://snapdeploy.dev/llms-full.md

Güvenlik modeli

  • Asla yıkıcı hiçbir şey yok. Aynı token ile ham bir API çağrısına yükselen bir aracı bile 403 INTERACTIVE_SESSION_REQUIRED alır.
  • Sırlar asla modele ulaşmaz. Ortam değişkeni değerleri (set) olarak geri gelir ve kimlik bilgileri maskelenir — yalnızca bu bağlayıcıda değil, sunucuda.
  • Kapsamlı, süreli, iptal edilebilir token'lar kendi hız sınırlarıyla birlikte gelir. API Anahtarları sayfasında iptal edin ve o andan itibaren her istek 401 döndürür.
  • Yeniden denemeye dayanıklı dağıtımlar. On dakika içindeki aynı istekler başka bir derleme başlatmak yerine orijinal dağıtımı döndürür.
  • Plan sınırları iletilir, yeniden denenmez. 402/429 yanıtları SnapDeploy'un kendi mesajını ve yükseltme bağlantısını taşır ve asistana yeniden denememesi söylenir.

Ortam değişkenleri

DeğişkenGerekliAnlam
SNAPDEPLOY_API_KEYevetKapsamlı token (sd_pat_…) veya eski API anahtarı
SNAPDEPLOY_READ_ONLYhayır1 yalnızca okuma araçlarını gösterir
SNAPDEPLOY_BASE_URLhayırVarsayılan https://snapdeploy.dev

Bağlantılar

MIT © AAR Labs