DevPilot

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

Installation

# Clone the repository
git clone 
cd mcp-vps-initialize

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Development

# Run in development mode
npm run dev

# Lint code
npm run lint
npm run lint:fix

# Format code
npm run format
npm run format:check

MCP Tools

1. SSH Connect

Connect to a VPS via SSH using password or private key authentication.

**Parameters:**

• host (required): VPS IP address or hostname
• username (required): SSH username
• port (optional): SSH port (default: 22)
• password (optional): SSH password
• privateKeyPath (optional): Path to private key file
• passphrase (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 install
  • nodejs (boolean): Install Node.js LTS
  • pm2 (boolean): Install PM2 process manager
  • rust (boolean): Install Rust toolchain
  • nginx (boolean): Install and configure Nginx
  • redis (boolean): Install and configure Redis

**Example: