SnapDeploy MCP

chính thức

Triển khai và quản lý ứng dụng SnapDeploy (container Docker trên AWS) từ Claude Code, Cursor, Codex hoặc Gemini CLI: bản dựng, nhật ký, biến môi trường, tiện ích bổ sung, tên miền.

GitHubDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với SnapDeploy MCP?

  • Triển khai kho lưu trữ GitHub — Yêu cầu trợ lý của bạn triển khai một kho lưu trữ lên SnapDeploy và nhận URL trực tiếp qua công cụ deploy.
  • Quản lý biến môi trường — Hướng dẫn trợ lý của bạn thiết lập hoặc kiểm tra các biến môi trường cho một container, với giá trị được che dưới dạng (set).
  • Theo dõi trạng thái triển khai — Yêu cầu trạng thái thời gian thực, nhật ký hoặc lịch sử triển khai cho bất kỳ container SnapDeploy nào.
  • Kiểm soát vòng đời container — Khởi động, dừng hoặc đánh thức một container theo yêu cầu mà không cần rời khỏi giao diện trò chuyện của bạn.
  • Cấp phát tài nguyên — Tạo cơ sở dữ liệu được quản lý hoặc gán tên miền tùy chỉnh cho các bản triển khai của bạn trực tiếp từ cuộc trò chuyện.

Tài liệu

@snapdeploy/mcp

Triển khai và quản lý các container SnapDeploy từ trợ lý AI của bạn — Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI, hoặc bất kỳ ứng dụng khách nào hỗ trợ Model Context Protocol qua stdio.

Nói "triển khai repo này lên SnapDeploy" và bạn sẽ nhận được một URL trực tiếp. Bản dựng, nhật ký, biến môi trường, cơ sở dữ liệu được quản lý và tên miền tùy chỉnh — mà không cần rời khỏi cuộc trò chuyện.

Thiết lập

  1. Đăng nhập tại snapdeploy.dev, mở API Keys và tạo một token với phạm vi deploy (trang sẽ tạo các đoạn mã bên dưới với token của bạn đã được điền sẵn).
  2. Thêm máy chủ vào ứng dụng khách của bạn:

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 và các ứng dụng khách cấu hình JSON khác:

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

Plugin Claude Code (token được lưu trữ trong bộ nhớ an toàn thay vì tệp cấu hình):

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

Khởi động lại phiên; các công cụ snapdeploy sẽ xuất hiện. Kho lưu trữ của bạn phải nằm trên GitHub và GitHub phải được kết nối với SnapDeploy một lần (trình kết nối sẽ trả về liên kết nếu chưa được kết nối).

Công cụ

Phạm viCông cụ
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

Các phạm vi lồng nhau (read ⊂ deploy ⊂ manage); máy chủ thực thi chúng trước khi bất kỳ công cụ nào chạy. Không có công cụ xóa, và máy chủ từ chối các thao tác xóa, hủy đăng ký và thay đổi mật khẩu cho mọi token — những thao tác đó cần một người đăng nhập vào bảng điều khiển hoặc ứng dụng di động.

Mô hình an toàn

  • Không có gì phá hủy, bao giờ. Ngay cả một tác nhân leo thang lên lệnh gọi API thô với cùng token cũng nhận được 403 INTERACTIVE_SESSION_REQUIRED.
  • Bí mật không bao giờ đến được mô hình. Giá trị biến môi trường được trả về dưới dạng (set) và thông tin xác thực được che — trên máy chủ, không chỉ trong trình kết nối này.
  • Token có phạm vi, hết hạn, thu hồi được với giới hạn tốc độ riêng. Thu hồi trên trang API Keys và mọi yêu cầu sẽ trả về 401 kể từ thời điểm đó.
  • Triển khai an toàn khi thử lại. Các yêu cầu giống hệt nhau trong vòng mười phút sẽ trả về bản triển khai ban đầu thay vì bắt đầu một bản dựng khác.
  • Giới hạn gói được chuyển tiếp, không thử lại. Các phản hồi 402/429 mang thông điệp riêng của SnapDeploy và liên kết nâng cấp, và trợ lý được yêu cầu không thử lại.

Biến môi trường

BiếnBắt buộcÝ nghĩa
SNAPDEPLOY_API_KEYcóToken có phạm vi (sd_pat_…) hoặc khóa API kế thừa
SNAPDEPLOY_READ_ONLYkhông1 chỉ hiển thị các công cụ đọc
SNAPDEPLOY_BASE_URLkhôngMặc định là https://snapdeploy.dev

Liên kết

MIT © AAR Labs