vps-mcp
Certified on Model Context Protocol Registry & Glama Directory →

Governed VPS MCP Server & Autonomous Digital Secretary

The open-source Model Context Protocol (MCP) server for VPS and Linux infrastructure. Turn Claude, Cursor, and agentic LLMs into safe Linux administrators with 45 deterministic tools, disposable Docker migration rehearsals, zero-downtime GitLab CI/CD, and Telegram triage.

$ uvx vps-mcp serve
45
Governed Tools
0
Remote Daemons (SSH-only)
100%
Dry-Run Preview Gate
A (3.8)
Glama Quality Tier
Interactive Demonstration

See VPS-MCP In Real-Time Action

Select a scenario below to inspect the MCP tool execution, parameters, and structured JSON-RPC responses.

vps-mcp inspector session
Executive Web Interface

Executive Web Cockpit

A dedicated full-stack console built for high-level operations. Complete with real-time SSE streaming, LaTeX math formula rendering, persistent sidebar chats, and live memory inspection.

VPS-MCP Executive Web Cockpit with LaTeX Formula Rendering and Chat History
Live Cockpit: Mathematical LaTeX rendering (Bayes' Theorem) + Sidebar Chat History
∑

KaTeX Math Formula Typesetting

Renders probability distributions, Bayes' Theorem, algorithmic complexities, and financial statistics flawlessly in chat threads.

💬

Persistent Sidebar Chats

Effortlessly switch between system maintenance chats, migration reviews, and secretary briefings with full conversational memory.

🧠

Agent Memory Inspector

Inspect verified architectural decisions, operator preferences, and procedures stored in the structured agent memory store.

Comprehensive Architectural Stack

The 6 Pillars of the Platform

Engineered from the ground up to eliminate the risks of autonomous AI agents while multiplying their capabilities.

🛡️

Zero-Footprint VPS Governance

Communicates over standard SSH using strict sudoers allowlists and rigid command templates. Eliminates arbitrary bash injection vulnerabilities. Every mutation provides a detailed dry-run preview.

16 Tools systemctl · docker · caddy
🗄️

Odoo & PostgreSQL Rehearsals

Never execute migrations on live production databases. Spawns isolated, disposable Docker containers to test complex Odoo schema upgrades, computes column-level diffs, and automatically purges test copies.

13 Tools pg_dump · odoo-bin · schema-diff
🚀

GitLab CI/CD & Deploy Engine

Inspect branches, commits, merge requests, and tail failed CI pipeline logs with automatic token/secret redacting. Trigger verified rolling deployments with instant rollback state pointers.

15 Tools gitlab-ci · rollback · audit
📚

Dense Knowledge Base RAG

Equips the AI assistant with dense vector search (Sentence Transformers + FAISS) over technical engineering books and architecture specs. Returns verbatim text snippets with exact page citations and scores.

Embedded RAG FAISS · DDIA · PDF Citations
✈️

Telegram MTProto Secretary

Connects directly to your personal Telegram account via Telethon MTProto (no generic bot token limits). Scans unread client messages, drafts replies, and waits for your confirmation before sending.

Executive Assistant Telethon · MTProto · DM Approval
🧠

Persistent Agent Memory

Cross-client knowledge store preserving facts, architectural decisions, operator preferences, and recovery runbooks with confidence scoring, provenance tracking, and expiration policies.

5 Tools Facts · Runbooks · Decisions
Model Context Protocol Schema

Interactive Tools Catalog

Search and inspect all 45 tools exposed over MCP stdio protocol.

Showing 45 of 45 tools
Defensive Engineering

Why Direct SSH Is Dangerous For LLMs

Unconstrained terminal access allows autonomous agents to hallucinate destructive commands or succumb to indirect prompt injections. VPS-MCP creates a zero-trust safety boundary.

✕

Raw SSH Terminal Access

  • ✕ Prompt Injection Hazard: Malicious log files or web content can trick the model into executing rm -rf / or exfiltrating private SSH keys.
  • ✕ Blind Mutations: Changes occur immediately without dry-run impact simulation or schema validation.
  • ✕ Zero State Rollback: If an upgrade fails or misconfigures Nginx, the agent lacks rollback pointers and downtime begins.
  • ✕ No Audit Trail: No centralized record of which tool executed what mutation and whether it was approved.
✓

VPS-MCP Governed Boundary

  • ✓ Rigid Command Templates: Never invokes raw shell syntax. Only allowlisted system commands with strictly parsed arguments.
  • ✓ Two-Phase Commit (confirm=false): Mutating actions generate a detailed preview first. Real execution requires operator approval.
  • ✓ Automatic Rollback Snapshots: Configurations and deployments save revision histories for instant single-command rollback.
  • ✓ Tamper-Evident Audit Log: Every action, timestamp, operator approval, and verified result is stored via get_audit_log.
Setup In 60 Seconds

Connect To Your Favorite AI Client

VPS-MCP adheres to the standard Model Context Protocol. Works out of the box with Claude Desktop, Cursor, VS Code, and custom agent harnesses.

// Claude Desktop Configuration (~/Library/Application Support/Claude/claude_desktop_config.json)
{
  "mcpServers": {
    "vps-mcp": {
      "command": "uvx",
      "args": [
        "vps-mcp",
        "serve",
        "--config",
        "/absolute/path/to/vps-mcp.toml"
      ]
    }
  }
}
💡 Zero-Config Introspection: You can test without an active VPS configuration! Running uvx vps-mcp serve boots directly into inspection fallback mode, exposing the consolidated compact catalog (or all 45 granular tools with --mode full) for exploration without live credentials.
Frequently Asked Questions

Everything You Need To Know

Clear answers on Model Context Protocol security boundaries, migration rehearsals, AI clients, and deployment architecture.

01 What is VPS-MCP and how does it relate to Model Context Protocol (MCP)?
VPS-MCP is a production-grade Model Context Protocol (MCP) server that equips AI assistants (such as Claude Desktop, Cursor, or autonomous agent loops) with 45 deterministic, sandboxed tools. Rather than giving raw terminal access to an LLM, VPS-MCP governs server management, database rehearsals, CI/CD pipelines, Telegram triage, and vector search through guarded JSON-RPC tools.
02 How does VPS-MCP prevent accidental or destructive server commands?
Direct SSH access carries immense risk—hallucinated or reckless rm -rf, unindexed SQL updates, or leaked SSH keys can destroy production. VPS-MCP introduces an immutable governance layer: dangerous destructive commands are strictly disallowed, every state modification requires dry-run previews, automated post-action verification checks run automatically, credentials and tokens are redacted, and every call is written to an append-only audit log.
03 Which AI clients and IDEs support VPS-MCP?
VPS-MCP is fully compliant with Anthropic's open Model Context Protocol standard. It works out-of-the-box with Claude Desktop, Cursor IDE, Zed, VS Code extensions (Cline, Roo Code, Continue), and any agent framework that supports stdio or SSE/mcp-proxy transports.
04 How does zero-downtime PostgreSQL and Odoo migration rehearsal work?
Before applying migrations on production databases, VPS-MCP spins up an isolated, temporary Docker container with an exact point-in-time clone of your database schema and data. It executes the migration script in this disposable sandbox, verifies integrity and schema diffs, measures execution time, and tears down the container without risking production uptime or data corruption.
05 What is the Digital Secretary executive cockpit and Telegram integration?
The Digital Secretary component acts as an autonomous executive companion: it connects directly to Telegram using MTProto to filter incoming messages and generate priority digests, manages personal calendars and reminders, indexes local documents with dense SQLite-vec + FTS5 vector search, and provides a modern Web Cockpit with live KaTeX LaTeX formula typesetting and multi-session chat history.
06 Is VPS-MCP open-source and free to self-host?
Yes, VPS-MCP is 100% open-source under the MIT License and self-hosted. There are no SaaS lock-ins, cloud telemetry trackers, or monthly subscription fees. You retain complete sovereignty over your servers, keys, databases, and private communications.
Copied to clipboard!