广告合作
MCP.so
登录

SnapDeploy MCP Server已验证已精选

@AAR-Labs

代码仓库主页文档

基本信息

分类

云与基础设施

许可证

MIT

作者

AAR-Labs

提交者

somdip-2310

关于 SnapDeploy MCP Server

从 Claude Code、Cursor、Codex 或 Gemini CLI 部署和管理 SnapDeploy 应用（运行在 AWS 上的 Docker 容器）：构建、日志、环境变量、附加服务、域名。

#docker#deployment#devops#cloud#aws#hosting#paas#claude-code#cursor#codex#gemini-cli

SnapDeploy MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

SnapDeploy MCP Server 工具

15

List the user's SnapDeploy containers with status and URL, plus plan, deploy-limit and free-hours state. Start here to find container ids/names.

Full status of one container (by name or id): state, URL, port, detected technology, resources. Env-var VALUES are never returned — names only.

Recent RUNTIME logs of a container (CloudWatch, up to 1000 lines). For BUILD logs of a deployment use get_deployments with a deployment_id.

Deployment history of a container, or one deployment in detail (status, error code/message and build-log tail — use this to diagnose a failed build).

Can the user deploy and run apps right now? Merges the deploy limit (5 per rolling 12h — ONLY for accounts without an Always-On/Sprint entitlement; failed attempts count) and the free-hours cap (containers refuse to start at 402 when exhausted), plus any unassigned Always-On subscriptions.

List (or search) the GitHub repositories connected to this SnapDeploy account. If GitHub is not connected yet, returns the connect link for the user.

Scan a repo for the environment variables it needs (import.meta.env / process.env usage). For known keys (Supabase etc.) the reply says where the user finds the value. Do this BEFORE the first deploy of a Lovable/Bolt/v0 export.

Deploy a connected GitHub repo to SnapDeploy: creates the container if needed, links the repo, builds, and waits for the result. Reply includes the live URL or, on failure, the error and build-log tail. On accounts without an Always-On/Sprint entitlement this uses one unit of the deploy limit (failed attempts count); Always-On accounts are uncapped.

Set/replace a container's environment variables (rolling restart, no rebuild). Values are accepted but NEVER echoed back. Public build-time names (VITE_*, NEXT_PUBLIC_*, REACT_APP_*) only take effect in the bundle after the next deploy.

Start a stopped container. May answer 402 when free hours are exhausted — relay that message and link, do not retry.

Stop a running container (safe, reversible — deletion is NOT possible through this connector by design).

Wake a sleeping free-plan container so its URL serves again.

Create a managed add-on: PostgreSQL, MySQL, MariaDB, MongoDB, Redis or RabbitMQ. Requires a purchased add-on subscription — without one this returns the purchase link (relay it, don't retry). Credentials are provisioned server-side and shown to the user in the SnapDeploy UI, never through this connector.

Attach a custom domain to a container. Returns the DNS records the user must create; verification then runs from the SnapDeploy UI.

Attach an UNASSIGNED Always-On subscription to a container (keeps it running 24/7 and lifts the deploy limit). Only call this after the user explicitly confirms — check_quota lists any unassigned subscriptions.

概览

What is SnapDeploy MCP?

A Model Context Protocol server that lets Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI or any stdio MCP client deploy and manage apps on SnapDeploy, a Docker container hosting platform on AWS. Say "deploy this repo to SnapDeploy" and get a live HTTPS URL back, then check builds, logs, environment variables, managed databases and custom domains without leaving the chat.

Setup

  1. Sign in at https://snapdeploy.dev, open API Keys and create a token with the deploy scope. The page generates the snippets with your token filled in.

  2. Add the server to your client. Claude Code:

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

    Any other client: use the JSON configuration on this page.

Tools (15)

  • read: list_apps, get_status, get_logs, get_deployments, check_quota, list_repos, detect_env_vars
  • deploy: deploy, set_env, start_container, stop_container, wake_container
  • manage: create_database, add_domain, assign_always_on

Scopes nest (read ⊂ deploy ⊂ manage) and the server enforces them before any tool runs.

Safety model

  • Nothing destructive, ever. There is no delete tool. Deletes, subscription cancellations and password changes are refused for every token, even if an agent escalates to a raw API call; they need a person signed in to the dashboard or the mobile app.
  • Secrets never reach the model. Environment-variable values come back as (set) and credentials are masked on the server, not just in the connector.
  • Scoped, expiring, revocable tokens with their own rate limit. Revoke on the API Keys page and every request returns 401 from that moment.
  • Retry-safe deploys. Identical requests inside ten minutes return the original deployment instead of starting another build.
  • Plan limits are relayed, not retried. 402 and 429 replies carry SnapDeploy's own message and upgrade link, and the assistant is told not to retry.

Use cases

  • Deploy a GitHub repository or a Dockerfile from the editor and get the live URL in the reply.
  • Read build and runtime logs while debugging, without opening a dashboard.
  • Set environment variables the app needs, detected from the code by detect_env_vars.
  • Add a managed Postgres, MySQL, MongoDB, Redis or RabbitMQ add-on and wire it in.
  • Wake a sleeping free-tier container, or move it to Always-On for 24/7 uptime.

常见问题

1

Do I need a paid SnapDeploy plan?

No. The free tier (4 containers, 100 running hours a month, 10 deploys a day, no credit card) works with the connector. Always-On, custom domains and databases are paid.

2

Which token scope should I use?

`deploy` for day-to-day work. `read` for a client that should only inspect. `manage` only if you want the assistant to create databases, add domains or assign Always-On.

3

Can the assistant delete my app or account?

No. There is no delete tool and the API refuses destructive calls from tokens. Those actions need a signed-in person.

4

Where are the docs and source?

Docs: https://snapdeploy.dev/docs/mcp. Source: https://github.com/AAR-Labs/snapdeploy-mcp (MIT). npm: `@snapdeploy/mcp`. Official MCP Registry: `io.github.somdip-2310/snapdeploy`.

评论

云与基础设施 分类下的更多 MCP 服务器

Kilo IoT Platform

Kilo IoT

Your AI can finally reach the physical world. Kilo is an AI-first IoT platform for commercial and industrial operations, and this connector hands a live deployment to the AI client you already use. Not an export. Not a

Query | MCP server for Supabase

alexander-zuev

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning, access to logs and much more.

828

monadomain-mcp

themonagroup

Buy .vn and 371 international domains in VND inside Claude Code, Codex or Cursor. Search and reserve as a guest, pay by VietQR, sign in with MONA Pass once to claim; the agent then points DNS and SSL at your app. Alias o

OutageDeck

outagedeck

Official OutageDeck MCP server for vendor-published cloud and SaaS status, incident timelines, and observed uptime history.

YesTechie — UniFi Network & Security Integrator

YesTechie

YesTechie builds enterprise UniFi networks, cameras, access control, cabling and Wi-Fi for businesses nationwide from its California HQ. Agents can read real project case studies and practical configuration guides, price

广告合作