Production-ready, zero-knowledge AI DevOps deployment, infrastructure provisioning, self-healing execution, and persistent documentation engine for VPS servers.
devops-deploy-guard-mcp-server is an advanced Model Context Protocol (MCP) server that empowers AI coding assistants (Antigravity IDE, Claude Code/Desktop, Cursor, Kimi, etc.) to safely provision servers, configure Nginx & SSL, deploy applications, debug mid-deployment failures interactively, and maintain persistent runbooks — without risking catastrophic production server crashes or database resets.
Production-ready, zero-knowledge AI DevOps deployment, infrastructure provisioning, self-healing execution engine, and runbook generator for VPS servers via Model Context Protocol (MCP).
스타
4
도구
—
가동 시간
—
🚀 Key Features in v1.7.0
🤖 Self-Healing Execution Engine: If a deployment command fails, the server pauses execution in a PAUSED_AWAITING_FIX state instead of instantly rolling back. The LLM receives full failure outputs, applies mid-deployment fixes via diagnose_and_fix, and resumes execution seamlessly via resume_execution.
📘 Auto-Runbook Generator (generate_project_runbook): Dynamically writes a physical DEPLOYMENT_RUNBOOK.md into the user's project root containing exact manual SSH commands, Nginx blocks, SSL status, and .env locations.
🧹 Safe Resource Cleanup (cleanup_server_resources): Checks root partition space (df -h /) and safely prunes dangling Docker images (docker image prune -f) and stale Git branches only if disk usage exceeds 70%.
🎯 Context-Aware Conditional Deployments (plan_dynamic_deployment): Inspects Git diffs against remote tracking branches to skip unnecessary npm install or database migrations when manifests and schemas haven't changed.
🛡️ Multi-OS Infrastructure Provisioning: Automatically detects Ubuntu, Debian, RHEL, CentOS, Fedora, and Alpine to generate idempotent provisioning plans for system packages, Node.js, PM2, Docker, UFW/Firewalld, Nginx, and Certbot SSL certificates.
🔒 Two-Tier Command Sanitizer: Hard-blocks catastrophic shell commands (rm -rf, DROP DATABASE, prisma migrate dev, :dev targets, --watch) while warning on risky operations (docker system prune, git reset --hard).
🔒 Security & Protection Architecture
Security Layer
Description
Two-Step Staged Execution
Planning tools output a plan_id. Execution requires explicitly invoking confirm_execution with confirm: true.
Command Sanitizer
Statically inspects all shell strings. Blocks catastrophic commands and dev flags in production environments.
Non-Fatal Pause Engine
Pauses failed deployments without destroying Git state, enabling LLMs to run diagnostic fix commands.
Secret Protection
.env files are written via SSH heredocs; actual key secrets are never echoed or dumped into LLM context logs.
Generates a local DEPLOYMENT_RUNBOOK.md containing manual SSH commands, Nginx config, SSL status, and .env locations.
cleanup_server_resources
Safely prunes dangling Docker images (docker image prune -f) and stale Git branches if disk usage is $>70%$.
⚡ Quick Start & Configuration Guide
🤖 Interactive AI Setup Wizard (Copy-Paste Prompt)
Instead of manually editing config files, copy the prompt below and paste it into your AI assistant (Antigravity IDE, Claude, Cursor, Kimi, etc.) to run an interactive setup wizard:
You are my AI DevOps Setup Assistant for devops-deploy-guard-mcp-server.
Please guide me through setting up this MCP server step-by-step by interviewing me first.
Ask me these questions in a clean list:
1. What is your VPS IP address or host domain?
2. What is your SSH username (e.g., root, ubuntu, deploy)?
3. What is the local path to your unencrypted SSH private key file (e.g., C:\Users\name\.ssh\id_rsa or ~/.ssh/id_rsa)?
4. What is your domain name (e.g., api.example.com) and admin email address for SSL?
5. Which AI IDE / MCP Client are you using (Antigravity IDE, Claude Desktop, Cursor, Kimi, etc.)?
After I answer:
- Create or update my local .devops-mcp.json config file with my responses.
- Ensure .devops-mcp.json and .deployment-history.json are listed in my .gitignore file.
- Generate the exact MCP client configuration JSON snippet formatted for my AI IDE.
- Compile the TypeScript server with `npm run build` and run `inspect_server` to verify SSH connectivity.
1. Manual Installation
cd devops-deploy-guard-mcp-server
npm install
npm run build
2. Configuration (.devops-mcp.json)
When launched, the server automatically creates a .devops-mcp.json file in your workspace root (and appends it to .gitignore):
Run generate_project_runbook to generate a complete markdown runbook for human developers and handovers.
Deployment History Log (.deployment-history.json):
Every deployment attempt (success, paused, or rolled back) is automatically logged with timestamp, plan ID, status, and executed commands.
🛠️ Development & Testing
# Watch mode for development
npm run dev
# Run Vitest unit tests
npm test
# Production build
npm run build
📄 License
MIT
D
Devops Deploy Guard
awais2o·스타 4개·
Production-ready, zero-knowledge AI DevOps deployment, infrastructure provisioning, self-healing execution engine, and runbook generator for VPS servers via Model Context Protocol (MCP).
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
Devops Deploy Guard에 API 키가 필요한가요?
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Devops Deploy Guard은(는) 어떤 전송 방식을 사용하나요?
Devops Deploy Guard은(는) stdio를 통해 로컬에서 실행됩니다.
Devops Deploy Guard은(는) 마지막으로 언제 확인되었나요?
마지막 확인: 2026-10-27. Production-ready, zero-knowledge AI DevOps deployment, infrastructure provisioning, self-healing execution engine, and runbook generator for VPS servers via Model Context Protocol (MCP).