Deploypilot

The Problem

AI coding assistants such as Claude, Cursor, TRAE, Coze, and SOLO are powerful, but they all share a fundamental limitation: they run inside sandboxed cloud environments with no direct SSH access to your servers.

This means your AI assistant cannot:

• Deploy applications to production servers
• Configure reverse proxies or allocate ports
• Manage DNS records across providers
• Provision or renew SSL certificates
• Open firewall rules on server management panels

The situation is even harder in enterprise environments where servers sit behind bastion hosts or jump servers that cloud-based IDEs cannot reach at all. Manual deployment remains tedious, error-prone, and wastes developer time.

DeployPilot bridges this gap by running on your server and exposing a standard MCP (Model Context Protocol) interface that any AI IDE can call — securely, remotely, and autonomously.

What is DeployPilot?

DeployPilot is a self-hosted AI IDE deployment gateway that uses the MCP protocol to let sandboxed AI assistants manage your server infrastructure. It installs in one line and gives your AI IDE full control over deployment, DNS, SSL, monitoring, and more.

One command to install. One prompt to deploy.

docker compose up -d

Then tell your AI:

"Deploy my project, set up DNS, and provision SSL."

DeployPilot handles the rest.

Quick Start

Docker (recommended)

# Clone the repository
git clone https://github.com/Yogdunana/deploypilot.git
cd deploypilot

# Set required environment variables
export JWT_SECRET=$(openssl rand -base64 24)
export REDIS_PASSWORD=$(openssl rand -base64 24)

# Start the service
docker compose up -d

Open http://localhost:8080 and register an admin account.

One-line install (binary)

curl -fsSL https://raw.githubusercontent.com/Yogdunana/deploypilot/main/scripts/install.sh | bash

The install script automatically downloads the latest binary, generates admin credentials, and sets up systemd services.

From source

git clone https://github.com/Yogdunana/deploypilot.git
cd deploypilot && make build-all

See DEPLOY.md for the full deployment guide, including PostgreSQL setup, reverse proxy configuration, and production hardening.

Architecture

DeployPilot uses a three-layer architecture designed for both AI agents and human operators:

flowchart LR
    subgraph S1["AI IDE Sandbox"]
        A[Claude / Cursor / TRAE / Coze / SOLO]
    end

    subgraph S2["DeployPilot Gateway"]
        B["MCP Server - 91+ tools"]
        C["REST API - JWT + RBAC"]
        D[WebSocket / SSE]
        E[Deploy Engine]
        F[Provider Plugins]
    end

    subgraph S3["Infrastructure"]
        G["1Panel / BT Panel"]
        H["Docker / Kubernetes"]
        I["Cloudflare / Aliyun DNS"]
        J["GitHub Actions / Gitea"]
    end

    A --> B
    A --> C
    C --> E
    B --> E
    E --> F
    F --> G
    F --> H
    F --> I
    F --> J

The embedded web dashboard (Vue 3 + TypeScript + Tailwind CSS) provides a full management UI accessible at http://localhost:8080.

Features

MCP Protocol Integration

91+ MCP tools covering the complete deployment lifecycle. AI IDEs connect via stdio transport and can autonomously manage your infrastructure through natural language.

Multi-Server Management

Register and manage multiple servers. Supports SSH-based remote servers, Docker (local and remote), and Kubernetes multi-cluster deployments. Detects server environments and installed panels automatically.

Docker Container Lifecycle

Full container management — create, deploy, start, stop, remove, and monitor containers. Supports automatic port allocation, health checks with configurable retries, backup and rollback, and self-healing with auto-restart and auto-rollback on failure thresholds.

DNS Management

Unified DNS record management across multiple providers:

SSL Certificate Automation

Request, list, renew, and delete SSL certificates directly from the MCP interface or web dashboard.

CI/CD Pipeline Integration

Trigger and monitor CI/CD builds without leaving your AI IDE. Supports GitHub Actions and Gitea.

Monitoring & Self-Healing

Real-time container and system metrics, configurable alert rules, and automatic container healing when failures are detected.

OAuth Login

Sign in with your GitHub or Gitee account — no separate password needed.

RBAC Authorization

Four-tier role-based access control: owner > admin > dev > viewer. Fine-grained permissions on every resource.

Audit Logging

Full change tracking with user identity, action type, IP address, and timestamp. Every operation is recorded and auditable.

i18n

Web dashboard available in English and Chinese, with a pluggable locale system.

Supported AI IDEs

DeployPilot integrates with any IDE that supports the MCP protocol. Configuration details for each IDE are available in docs/ide-skills.md.

All IDEs use the same configuration pattern:

{
  "mcpServers": {
    "deploypilot": {
      "command": "/path/to/mcp-server",
      "args": ["--config", "/path/to/config.yaml"]
    }
  }
}

See docs/ide-skills.md for IDE-specific instructions, skill files, and rules templates.

Configuration

DeployPilot is configured via config.yaml. All settings can also be overridden with environment variables using the DEPLOYPILOT_ prefix (e.g., DEPLOYPILOT_SERVER_PORT for server.port).

server:
  host: "0.0.0.0"
  port: 8080
  cors_allowed_origins:
    - []

database:
  type: sqlite              # sqlite | postgres
  dsn: ./data/deploypilot.db

redis:
  addr: localhost:6379
  password: ""
  db: 0

auth:
  jwt_secret: "change-me-in-production"  # Required: set a strong random value
  token_expire: 24h

deploy:
  default_mode: api
  build_timeout: 10m
  health_check_interval: 30s
  health_check_retries: 3
  rollback_on_failure: true

log:
  level: info               # debug | info | warn | error
  format: json              # json | text
  file: ./logs/deploypilot.log
  enable_tracing: true

monitor:
  enabled: true
  metrics_port: 9091

See configs/config.yaml.example for the full example and DEPLOY.md for all environment variables.

Documentation

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for development setup, coding conventions, and pull request guidelines.

License

This project is licensed under the Business Source License 1.1 (BSL 1.1).

> Non-commercial use is permitted — including personal use, internal use within organizations, testing/evaluation, and non-commercial educational use. See LICENSE for full terms. > > On 2029-04-28, this license automatically converts to MIT.

© 2026 Yogdunana