VPS Initialize
Provides automated VPS initialization and management capabilities for Debian-based systems, including system updates and service installations
Enables automated CI/CD pipeline setup with deploy key generation, GitHub Actions workflow creation, and repository deployment automation
Automates SSL certificate generation and configuration for domains using Let's Encrypt through Certbot integration
Provides automated Nginx installation, configuration, domain setup with reverse proxy capabilities, and SSL certificate integration
Enables automated Node.js LTS installation and setup as part of VPS initialization services
Provides automated PM2 process manager installation and configuration for Node.js application management
Enables automated Redis installation and configuration as part of VPS service initialization
Provides automated Rust toolchain installation and setup as part of VPS initialization services
Provides automated VPS initialization and management capabilities for Ubuntu systems, including system updates and service installations
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., "@VPS Initialize initialize my VPS with Node.js, Nginx, and Redis"
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 VPS Initialize
A Model Context Protocol (MCP) server for automated VPS initialization and management. This tool provides SSH-based automation for setting up fresh VPS instances with common services and CI/CD pipelines.
Features
π SSH Authentication: Supports both password and private key authentication
π οΈ VPS Initialization: Automated setup of Node.js, PM2, Rust, Nginx, Redis
π Nginx Configuration: Domain setup with reverse proxy and SSL certificates
π GitHub CI/CD: Automated deploy key generation and workflow creation
π Comprehensive Logging: Winston-based structured logging
π§ TypeScript: Fully typed with strict TypeScript configuration
Related MCP server: ssh-alias-mcp
Installation
# Clone the repository
git clone <repository-url>
cd mcp-vps-initialize
# Install dependencies
npm install
# Build the project
npm run build
# Start the server
npm startDevelopment
# Run in development mode
npm run dev
# Lint code
npm run lint
npm run lint:fix
# Format code
npm run format
npm run format:checkMCP Tools
1. SSH Connect
Connect to a VPS via SSH using password or private key authentication.
Parameters:
host(required): VPS IP address or hostnameusername(required): SSH usernameport(optional): SSH port (default: 22)password(optional): SSH passwordprivateKeyPath(optional): Path to private key filepassphrase(optional): Private key passphrase
Example:
{
"host": "192.168.1.100",
"username": "root",
"password": "your-password"
}2. VPS Initialize
Initialize a fresh VPS with system updates and optional services.
Parameters:
services(optional): Object specifying which services to installnodejs(boolean): Install Node.js LTSpm2(boolean): Install PM2 process managerrust(boolean): Install Rust toolchainnginx(boolean): Install and configure Nginxredis(boolean): Install and configure Redis
Example:
{
"services": {
"nodejs": true,
"pm2": true,
"nginx": true,
"redis": false
}
}3. Nginx Setup
Configure Nginx with domain, reverse proxy, and SSL certificates.
Parameters:
domain(required): Domain name for the siteport(required): Backend port to proxy requests tossl(optional): Enable SSL with Certbot (default: true)
Example:
{
"domain": "example.com",
"port": 3000,
"ssl": true
}4. GitHub CI/CD Setup
Setup GitHub CI/CD with deploy keys and automated workflows.
Parameters:
repoUrl(required): GitHub repository URLdeployPath(required): Deployment path on the server
Example:
{
"repoUrl": "https://github.com/username/repo.git",
"deployPath": "/opt/deployments/myapp"
}5. Execute Command
Execute arbitrary commands on the connected VPS.
Parameters:
command(required): Command to execute
Example:
{
"command": "systemctl status nginx"
}Workflow
Basic VPS Setup
Connect to VPS:
{ "tool": "ssh_connect", "args": { "host": "your-vps-ip", "username": "root", "password": "your-password" } }Initialize VPS:
{ "tool": "vps_initialize", "args": { "services": { "nodejs": true, "pm2": true, "nginx": true } } }Setup Nginx:
{ "tool": "nginx_setup", "args": { "domain": "yourdomain.com", "port": 3000, "ssl": true } }Setup CI/CD:
{ "tool": "github_cicd_setup", "args": { "repoUrl": "https://github.com/username/repo.git", "deployPath": "/opt/deployments/myapp" } }
GitHub CI/CD Instructions
After running the github_cicd_setup tool, you'll receive:
Deploy Key: Add to your GitHub repository's Deploy Keys
GitHub Secrets: Add to your repository's Actions secrets
Workflow File: Add to
.github/workflows/deploy.yml
The generated workflow will:
Trigger on pushes to main/master branch
Run tests (if available)
Build the application (if build script exists)
Deploy to your VPS automatically
Security Features
Firewall Configuration: Automatic UFW setup with secure defaults
SSL Certificates: Automated Let's Encrypt certificate generation
SSH Key Management: Secure deploy key generation
Process Isolation: Optional deploy user creation
Logging
Logs are written to:
logs/combined.log: All log levelslogs/error.log: Error logs onlyConsole: Formatted output with colors
Log levels: error, warn, info, debug
Configuration
The server can be configured through environment variables:
LOG_LEVEL: Set logging level (default: 'info')PORT: Server port (if running standalone)
Troubleshooting
Common Issues
SSH Connection Failed
Verify IP address and credentials
Check firewall settings
Ensure SSH service is running
SSL Certificate Issues
Verify domain DNS points to server
Check firewall allows HTTP/HTTPS
Ensure email is valid for Let's Encrypt
Service Installation Failed
Check system update status
Verify internet connectivity
Review error logs
Debug Mode
Enable debug logging:
LOG_LEVEL=debug npm startRequirements
Node.js 18+
Fresh Ubuntu/Debian VPS
Domain name (for SSL setup)
GitHub repository (for CI/CD)
License
MIT License - see LICENSE file for details.
Available Tools
5 toolsexecute_commandC
Execute a command on the connected VPS
Inputs: command (required).
github_cicd_setupC
Setup GitHub CI/CD with deploy keys and workflow
Inputs: repoUrl (required), deployPath (required).
nginx_setupC
Configure Nginx with domain, reverse proxy, and SSL
Inputs: domain (required), port (required), ssl.
ssh_connectC
Connect to a VPS via SSH using password or private key
Inputs: host (required), username (required), port, password, +2 more.
vps_initializeC
Initialize a fresh VPS with basic setup and optional services
Inputs: services.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: execute_command runs commands, github_cicd_setup configures CI/CD, nginx_setup handles web server setup, ssh_connect establishes SSH connections, and vps_initialize performs initial VPS setup. There is no overlap or ambiguity between these functions.
Most tools follow a consistent verb_noun pattern (e.g., execute_command, nginx_setup, ssh_connect), but github_cicd_setup uses an acronym and vps_initialize includes 'vps' as a prefix, which slightly deviates from the pattern. Overall, the naming is readable and mostly predictable.
With 5 tools, the server is well-scoped for VPS initialization tasks. Each tool serves a specific, necessary function in the setup process, from connecting to the VPS to configuring services, making the count appropriate and efficient.
The toolset covers core VPS initialization workflows, including connection, basic setup, command execution, web server configuration, and CI/CD integration. A minor gap might be the lack of tools for monitoring or backup setup, but agents can work around this with existing tools.
Maintenance
Related MCP Connectors
Deploy and manage applications, databases, domains, and git repos
Manage PHP apps on your own Ubuntu servers: deploy, roll back and inspect Laravel and WordPress
Zero-Ops deploy of a private AI workspace to your own VPS β from your AI chat. Free and open-source.
Manage servers through SSH.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to securely manage Virtual Private Servers via SSH, with features including command execution, file operations, system monitoring, and service management.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to SSH into Linux servers, run commands, deploy code, and manage servers via natural language, also doubles as a CLI for manual use.3MIT
- FlicenseAqualityDmaintenanceGives AI assistants full control over a VPS via SSH, enabling command execution, file management, service control, Docker and firewall management.96-
- AlicenseNot gradedqualityDmaintenanceEnables SSH command execution, file uploads/downloads, and multi-server management with zero-config inline credentials, supporting async jobs and AI-readable output.32 npm2AGPL 3.0