---

📖 Table of Contents

• About
• Features
• Compatibility
• Quick Start
• Installation
• Configuration
• Available Tools
• Security
• Documentation
• Support
• License

---

🎯 About

Google VPS MCP is a professional-grade Model Context Protocol (MCP) server that enables AI assistants to manage your Google Cloud VPS instances securely and efficiently. Built with TypeScript and designed for production use, it provides seamless integration with ChatGPT, Claude Desktop, and any MCP-compatible AI tool.

🌟 Key Features

• 🖥️ Complete VPS Setup - Automated VPS configuration with security hardening, Node.js, PM2, and firewall rules
• 🚀 One-Click Deploy - Deploy directly from GitHub with automatic dependency installation and PM2 configuration
• 📊 Live Logs - Real-time log streaming, search capabilities, and AI-powered troubleshooting
• 🔐 Secure Environment - Manage .env files securely with validation, backup, and masked sensitive values
• 🤖 AI Integration - Works with ChatGPT, Claude Desktop, Google Antigravity, OpenCode, and any MCP client
• 🔒 Enterprise Security - Command validation, sensitive data masking, audit logging, and secure authentication

🚀 What You Can Do

Perfect for developers who want to:

• Deploy projects directly from GitHub to Google Cloud VPS
• Monitor applications with live logs and real-time metrics
• Redeploy with a single command
• Manage environment variables securely
• Troubleshoot issues with AI assistance
• Control VPS instances using natural language

💼 Use Cases

• Startups - Quick deployment of web applications to Google Cloud
• Developers - Automated VPS management without manual SSH commands
• DevOps - AI-assisted monitoring and troubleshooting
• Agencies - Multi-client VPS management with project isolation
• Freelancers - Professional deployment workflow with minimal setup

---

✨ Features

---

🔌 Compatibility

Google VPS MCP works with any AI tool that supports the Model Context Protocol (MCP):

---

⚡ Quick Start

# 1️⃣ Clone the repository
git clone https://github.com/dannymaaz/google-vps-mcp.git
cd google-vps-mcp

# 2️⃣ Install dependencies
npm install

# 3️⃣ Build the project
npm run build

# 4️⃣ Authenticate with Google Cloud
gcloud auth application-default login

---

📦 Installation

Prerequisites

Ensure you have the following installed:

Requirement	Version	Purpose
Node.js	>= 18.0.0	Runtime environment
Google Cloud SDK	Latest	GCP authentication
Git	Latest	Version control

Step-by-Step Installation

# Clone the repository
git clone https://github.com/dannymaaz/google-vps-mcp.git
cd google-vps-mcp

# Install all dependencies
npm install

# Build the TypeScript code
npm run build

# Verify installation
npm run build

---

⚙️ Configuration

🎯 Automatic Project Selector (NEW!)

No need to manually enter Project IDs anymore!

Google VPS MCP now includes an automatic project selector that lists all your Google Cloud projects:

# Run the interactive selector
npm run setup

This will:

1. List all your Google Cloud projects
2. Let you select the one you want to use
3. Automatically configure both .env and Antigravity
4. You're ready to go!

Manual Configuration

If you prefer manual setup:

# Option 1: User authentication (development)
gcloud auth application-default login

# Option 2: Service account (production)
gcloud auth activate-service-account --key-file=path/to/service-account.json

Note: You don't need to set a project ID in configuration. The MCP will list your projects and you can choose dynamically when creating resources.

---

🛠️ Available Tools

VPS Management

Tool	Description
vps_setup	Create and configure a new VPS from scratch
vps_status	Get comprehensive VPS status and metrics
restart_service	Restart services or applications
execute_command	Run validated commands securely

Deployment

Tool	Description
deploy_project	Deploy from GitHub with full configuration
redeploy	Pull latest changes and restart application

Logs & Monitoring

Tool	Description
view_logs_live	Stream logs in real-time
search_logs	Search historical logs with filters
troubleshoot_logs	AI-friendly log analysis with suggestions

Environment

Tool	Description
configure_env	Create or update .env file
upload_env	Upload .env file securely
get_env	Retrieve environment configuration

---

🔌 AI Integration Setup

ChatGPT Setup

1. Install an MCP-compatible ChatGPT client
2. Add the following configuration:

{
  "mcpServers": {
    "google-vps": {
      "command": "node",
      "args": ["/path/to/google-vps-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Claude Desktop Setup

Edit claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-vps": {
      "command": "node",
      "args": ["/absolute/path/to/google-vps-mcp/dist/index.js"],
      "env": {}
    }
  }
}

---

🔒 Security

Blocked Operations

The following are automatically blocked for security:

• ❌ System modifications (rm -rf /, chmod -R 777)
• ❌ Privilege escalation attempts
• ❌ Service disruption commands
• ❌ Data destruction operations
• ❌ Network backdoors

---

📚 Documentation

---

👨‍💻 Created By

---

💖 Support

---

📄 License

---