vps-mcp
Provides tools to inspect Docker container status, retrieve container logs, and restart containers on a Linux VPS.
Enables an AI assistant to operate a Linux VPS by checking system health, viewing ports, disk and memory usage, checking UFW firewall status, and managing systemd services.
Provides tools to test nginx configuration, inspect nginx site configuration, and reload nginx only when configuration validation passes.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
vps-mcp
EN: An MCP server that lets an AI assistant operate a Linux VPS — Docker, nginx, systemd, health checks, ports, disk/memory, firewall — through 13 narrow tools instead of a raw shell. Every parameter that reaches a shell is validated against an allowlist pattern or quoted.
Servidor MCP para que un asistente de IA opere un VPS con herramientas acotadas, no con una terminal libre.
Herramientas (13)
Área | Herramientas |
Docker |
|
nginx |
|
systemd |
|
Salud |
|
Related MCP server: VPS Docker MCP (Advanced)
Seguridad
Un MCP que ejecuta comandos es un riesgo en cuanto un parámetro llega a un shell. Aquí:
Nombres de unidad y contenedor deben casar con
^[A-Za-z0-9][A-Za-z0-9_.@-]{0,99}$; el intervalosince, con^\d{1,4}[smhd]?$;linesse limita a 1–1000.service_restartsolo acepta servicios de la lista configurada.El filtro de
nginx_configy las URL dehealth_checkpasan porshlex.quote.Una entrada inválida devuelve
REJECTED: …; nunca llega al shell.
service_logs("x; rm -rf /") -> REJECTED: invalid name: 'x; rm -rf /'
docker_logs("ok", since="1;id") -> REJECTED: invalid interval: '1;id'
service_restart("sshd") -> REJECTED: 'sshd' is not in the configured service listAun así, run() usa shell=True por las tuberías (| head, | grep): no expongas este servidor a
entradas no confiables y córrelo con el usuario mínimo necesario.
Configuración
Todo es opcional, por variables de entorno:
Variable | Qué hace |
| JSON |
| URL pública que revisa |
| archivo de sitio de nginx para |
| contenedor por defecto de |
| puertos que muestra |
Uso
pip install "mcp[cli]>=1.0.0"
python3 server.py # transporte stdioRegístralo en tu cliente MCP como un servidor stdio con ese comando.
Licencia
MIT — ver LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Secure Linux sandboxes for AI agents, as MCP tools.
Linux VMs for AI agents: create VMs, run commands, edit files and open preview URLs.
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
Related MCP Servers
- FlicenseAqualityDmaintenanceGives AI assistants full control over a VPS via SSH, enabling command execution, file management, service control, Docker and firewall management.96-
- FlicenseBqualityBmaintenanceEnables safe VPS diagnostics and Docker/Docker Compose management over SSH, providing predefined read-only and mutating tools for system monitoring, container inspection, and Compose orchestration without exposing arbitrary shell execution.26-
- AlicenseAqualityBmaintenanceEnables AI agents to safely monitor Linux VPS health, inspect Docker containers, retrieve service logs, and execute whitelisted recovery actions via MCP.31134 npm93 PyPIMIT
- FlicenseNot gradedqualityBmaintenanceEnables controlled diagnostics and limited actions on a VPS through safe, auditable tools instead of an unrestricted root terminal, including read-only checks, basic Docker status, allowed-path file reading/searching, and YAML/JSON validation.-