mcp-cloud-deploy
Allows running projects locally with Docker Compose, including auto-generation of Dockerfiles and compose files with optional PostgreSQL, MongoDB, and Redis services.
Allows provisioning MongoDB Atlas clusters, including project and cluster creation, database users, IP whitelisting, and different tiers.
Allows deploying applications to Railway, with optional PostgreSQL, Redis, and MongoDB plugins, and configurable environment variables and regions.
Allows deploying projects to Vercel, with automatic framework detection, production/preview deployments, environment variables, and custom build commands.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-cloud-deploy Deploy my project to Vercel and create a Neon PostgreSQL database"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Cloud Deploy
Model Context Protocol server for deploying projects to multiple cloud platforms via CLI.
Deploy your projects to Vercel, Railway, Neon (PostgreSQL), MongoDB Atlas, Docker (local), or run them as local dev servers — all through natural language commands from any MCP-compatible client (Kiro, Claude Desktop, etc.).
Features
Tool | Description |
| Deploy frontend/fullstack apps to Vercel |
| Deploy apps to Railway with database plugins |
| Create serverless PostgreSQL on Neon |
| Create MongoDB Atlas clusters |
| Run with Docker Compose (auto-generates configs) |
| Start native local dev server |
| Full-stack deploy combining multiple services |
| Verify which CLIs are installed |
Related MCP server: project-scaffold
Quick Start
1. Install
# Clone or download this project
cd mcp-cloud-deploy
# Install dependencies
npm install
# Build
npm run build2. Configure in your MCP client
For Kiro / Claude Desktop — add to your MCP config:
{
"mcpServers": {
"cloud-deploy": {
"command": "node",
"args": ["/absolute/path/to/mcp-cloud-deploy/dist/index.js"]
}
}
}For development (with auto-reload):
{
"mcpServers": {
"cloud-deploy": {
"command": "npx",
"args": ["tsx", "/absolute/path/to/mcp-cloud-deploy/src/index.ts"]
}
}
}3. Get your API tokens
Service | Where to get token |
Vercel | |
Railway | |
Neon | |
MongoDB Atlas | Organization > Access Manager > API Keys |
4. Install CLIs (only the ones you need)
# Vercel
npm install -g vercel
# Railway
npm install -g @railway/cli
# Neon
npm install -g neonctl
# MongoDB Atlas
brew install mongodb-atlas-cli # macOS
# Or: https://www.mongodb.com/docs/atlas/cli/stable/install-atlas-cli/
# Docker (for local deployments)
# https://docs.docker.com/get-docker/Usage Examples
Deploy a Next.js app to Vercel
"Deploy my project at /home/user/my-app to Vercel. Here's my token: vercel_xxxxx"The MCP will call deploy_to_vercel with:
Auto-detect framework (Next.js)
Deploy as preview (or production if specified)
Return the deployment URL
Full-stack: Vercel + Neon PostgreSQL
"Deploy my app to Vercel with a PostgreSQL database on Neon.
Vercel token: vercel_xxx
Neon API key: neon_xxx
Project name: my-saas-app"The orchestrate_deploy tool will:
Create a Neon project + database
Get the connection string
Deploy to Vercel with
DATABASE_URLinjected
Deploy everything on Railway
"Put my project on Railway with a PostgreSQL database.
Token: railway_xxx
Path: /home/user/my-api"Railway handles app + database in one platform.
Local development with Docker
"Start my project locally with Docker, include PostgreSQL and Redis"This will:
Auto-generate a Dockerfile (based on project type)
Generate docker-compose.yml with app + PostgreSQL + Redis
Build and start all containers
Return URLs for each service
Quick local dev server
"Run my project locally at /home/user/my-app on port 4000"Auto-detects Node.js/Python/Go/Rust and runs the appropriate dev command.
Tools Reference
deploy_to_vercel
Parameter | Required | Description |
| Yes | Absolute path to project |
| Yes | Vercel API token |
| No | Deploy to production (default: false) |
| No | Vercel Team ID |
| No | Custom project name |
| No | Environment variables object |
| No | Custom build command |
| No | Framework preset |
deploy_to_railway
Parameter | Required | Description |
| Yes | Absolute path to project |
| Yes | Railway API token |
| No | Railway project name |
| No | Service name |
| No | Add PostgreSQL (default: false) |
| No | Add Redis (default: false) |
| No | Add MongoDB (default: false) |
| No | Environment variables |
| No | Deploy region |
provision_neon_database
Parameter | Required | Description |
| Yes | Neon API key |
| Yes | Neon project name |
| No | Database name (default: main) |
| No | Role name (default: app_user) |
| No | Region (default: aws-us-east-1) |
| No | Path to .sql schema file |
| No | Migration command to execute |
| No | Working directory for migrations |
provision_mongodb
Parameter | Required | Description |
| Yes | Atlas public API key |
| Yes | Atlas private API key |
| Yes | Atlas Organization ID |
| Yes | Atlas project name |
| Yes | Cluster name |
| No | Tier: M0 (free), M2, M5, M10... |
| No | AWS, GCP, AZURE (default: AWS) |
| No | Region (default: US_EAST_1) |
| No | Database name (default: main) |
| No | Username (default: app_user) |
| No | Password (auto-generated) |
| No | Allow all IPs (default: false) |
| No | List of IPs to whitelist |
deploy_docker_local
Parameter | Required | Description |
| Yes | Absolute path to project |
| No | Docker service name (default: app) |
| No | Port to expose (default: 3000) |
| No | Include PostgreSQL container |
| No | Include MongoDB container |
| No | Include Redis container |
| No | Additional env vars |
| No | Custom Dockerfile path |
| No | Auto-generate Dockerfile (default: true) |
| No | Generate docker-compose.yml (default: true) |
| No | Build before start (default: true) |
| No | Run in background (default: true) |
deploy_local
Parameter | Required | Description |
| Yes | Absolute path to project |
| No | Port (default: 3000) |
| No | Install dependencies (default: true) |
| No | Migration command |
| No | Seed command |
| No | Environment variables |
| No | Path to .env file |
| No | Custom start command (auto-detected) |
| No | Run in background (default: true) |
orchestrate_deploy
Parameter | Required | Description |
| Yes | Absolute path to project |
| Yes | One of: |
| Yes | Object with tokens for each service |
| Yes | Project name |
| No | Production mode (default: false) |
| No | Additional env vars |
| No | Path to DB schema file |
| No | Port for local targets (default: 3000) |
check_deploy_prerequisites
No parameters. Returns a table showing which CLIs are installed.
Architecture
mcp-cloud-deploy/
├── src/
│ ├── index.ts # Entry point - stdio transport
│ ├── server.ts # MCP server with all tools registered
│ ├── tools/
│ │ ├── vercel.ts # Vercel deployment logic
│ │ ├── railway.ts # Railway deployment logic
│ │ ├── neon.ts # Neon PostgreSQL provisioning
│ │ ├── mongodb.ts # MongoDB Atlas provisioning
│ │ ├── docker-local.ts # Docker Compose local deployment
│ │ ├── local.ts # Native local dev server
│ │ └── orchestrator.ts # Multi-service orchestration
│ ├── auth/
│ │ └── token-manager.ts # In-memory token handling
│ └── utils/
│ ├── cli-runner.ts # Safe CLI execution wrapper
│ └── logger.ts # Stderr logger (MCP-safe)
├── dist/ # Compiled JavaScript
├── package.json
└── tsconfig.jsonSecurity
Tokens are NEVER persisted to disk — they exist only in memory during the session
Tokens are passed per-call — each tool invocation includes the token it needs
stderr for logging — all logs go to stderr to not interfere with MCP stdio
CLI execution is sandboxed — commands run with timeouts and buffer limits
Supported Project Types (Auto-detection)
The Docker and local tools automatically detect your project type:
Type | Detection | Dev Command | Docker Base |
Next.js |
|
| Multi-stage Node 20 |
Nuxt |
|
| Node 20 |
SvelteKit |
|
| Node 20 |
Vite |
|
| Node 20 |
Express/Fastify |
|
| Node 20 |
Python/FastAPI |
|
| Python 3.12 |
Django |
|
| Python 3.12 |
Go |
|
| Go 1.22 multi-stage |
Rust |
|
| Rust multi-stage |
Development
# Run in development mode (with tsx)
npm run dev
# Build for production
npm run build
# Run built version
npm start
# Clean build output
npm run cleanLicense
MIT
Available Tools
8 toolscheck_deploy_prerequisitesA
Check which deployment CLIs are installed and available. Shows status of: vercel, railway, neonctl, atlas, docker, docker-compose, git, node, npm.
Inputs: no named parameters.
deploy_docker_localA
Deploy the project locally using Docker/Docker Compose. Auto-generates Dockerfile and docker-compose.yml. Can include PostgreSQL, MongoDB, and Redis containers. Requires Docker to be installed and running.
Inputs: projectPath (required), port, build, detach, +8 more.
deploy_localA
Start the project locally as a native development server. Auto-detects project type (Node.js, Python, Go, Rust) and runs the appropriate dev command. Handles dependency installation, migrations, and seeding.
Inputs: projectPath (required), port, envFile, envVars, +5 more.
deploy_to_railwayA
Deploy a project to Railway with optional database plugins (PostgreSQL, Redis, MongoDB). Railway handles the full stack. Requires a Railway API token.
Inputs: token (required), projectPath (required), region, envVars, +5 more.
deploy_to_vercelA
Deploy a project to Vercel (frontend, fullstack, or API). Supports Next.js, Vite, Nuxt, SvelteKit, and more. Requires a Vercel API token.
Inputs: token (required), projectPath (required), teamId, envVars, +4 more.
orchestrate_deployA
Orchestrate a full-stack deployment combining multiple services. Targets: vercel+neon, vercel+mongodb, railway-fullstack, docker-local, local. Provisions databases and deploys apps with all environment variables connected automatically.
Inputs: target (required), tokens (required), projectName (required), projectPath (required), +4 more.
provision_mongodbA
Create a MongoDB Atlas cluster with database and user. Supports free tier (M0) through dedicated clusters. Requires MongoDB Atlas API keys (public + private).
Inputs: orgId (required), publicKey (required), privateKey (required), clusterName (required), +9 more.
provision_neon_databaseA
Create a serverless PostgreSQL database on Neon. Supports schema application and migration commands. Requires a Neon API key.
Inputs: apiKey (required), projectName (required), region, roleName, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct action and target: deploy to specific cloud providers, provision specific database types, local deployment modes, orchestration, and prerequisites checking. While deploy_to_vercel and deploy_to_railway share the deploy action, their distinct target platforms and descriptions eliminate ambiguity.
Most tools follow a clear verb_noun pattern (provision_neon_database, orchestrate_deploy, check_deploy_prerequisites). Minor inconsistency: deploy_to_vercel and deploy_to_railway use 'to_' while deploy_docker_local and deploy_local omit it, but the patterns remain predictable and readable.
8 tools is well-scoped for a deployment/provisioning server. Each tool covers a necessary part of the deployment lifecycle—cloud deploy, database provisioning, local deploy, orchestration, and prerequisites—without redundancy or bloat.
The tool set covers core deployment workflows: cloud deploy, database provisioning, local deployment (Docker and native), multi-service orchestration, and environment checks. Minor gaps include no teardown/destroy or status/listing tools, but these are not essential for the stated purpose.
Maintenance
Related MCP Connectors
Build, deploy, and host full-stack web apps from any MCP client. DB, auth, storage, cron included.
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceUnified deployment dashboard MCP server for AI agents. 9 tools to manage services across Vercel, Render, Railway, and Fly.io — deploy status, logs, service listing, environment variables, rollback, and health checks from one endpoint. Free tier: 50 requests/IP/day.3MIT
- AlicenseAqualityDmaintenanceAn MCP server that scaffolds full-stack projects with consistent structure, Docker setup, CI/CD pipelines, and database configuration.6MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables Claude to deploy full-stack web apps to Cloudflare, including databases, authentication, and file storage, directly through natural language.-
- AlicenseAqualityBmaintenanceMCP server for managing a self-hosted Coolify instance. Provides full REST CRUD, deploy/watch capabilities, and an optional host-ops tier for live log streaming, SSH, Docker, and database access.227 npmMIT