🚀 Google VPS MCP

Professional & Secure MCP Server for Google Cloud VPS Management

Deploy • Monitor • Manage your Google Cloud VPS with AI assistance

Documentation • Features • Quick Start • Support

---

📖 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

🖥️ VPS Setup	🚀 One-Click Deploy	📋 Live Logs
Automated VPS configuration	Deploy from GitHub instantly	Real-time log streaming
Security hardening included	PM2 process management	Search & filter capabilities
Node.js & PM2 pre-installed	Custom build commands	AI-powered troubleshooting

🔐 Env Management	📊 Monitoring	🔒 Enterprise Security
Secure .env file handling	CPU & memory tracking	Command validation
Backup before changes	Disk usage monitoring	Sensitive data masking
Validation & sanitization	Process management	Audit logging

---

🔌 Compatibility

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

AI Tool	Status	Configuration
ChatGPT	✅ Supported	Guide
Claude Desktop	✅ Supported	Guide
OpenCode	✅ Supported	MCP-compatible
Google Antigravity	✅ Supported	MCP-compatible
Other MCP Clients	✅ Supported	Standard MCP config

---

⚡ Quick Start

Get up and running in 4 steps!

# 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

➡️ See Full Documentation

---

📦 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

Feature	Description
🛡️ Command Validation	Blocks dangerous operations automatically
🔐 Env Masking	Hides sensitive values (passwords, keys, tokens)
📋 Audit Logging	Records all operations for review
🔑 Secure Auth	Uses official Google Cloud libraries

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

🌐 View Full Documentation

• 📖 Complete tool reference
• 🔧 Detailed integration guides
• 🛠️ Troubleshooting guides
• ❓ FAQ section

Available in: 🇺🇸 English | 🇪🇸 Español

---

👨‍💻 Created By

Danny Maaz

---

💖 Support

If you find this project helpful, consider supporting its development:

PayPal: paypal.me/Creativegt

Ko-fi: ko-fi.com/X8X71W99D6

---

📄 License

MIT License

Copyright © 2024 Danny Maaz

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software.

---

🌟 Star this repo if you find it useful!

Google VPS MCP — Professional VPS Management with AI

Documentation • Report Bug • Request Feature