server-ops-mcp

MCP server for VPS management — SSH commands, Docker containers, service management, GitHub integration, deployments, and monitoring.

Uses lazy category loading — only meta-tools are registered at startup. The agent enables categories on demand.

Quick Start

1. Install

pip install server-ops-mcp

2. Setup your VPS (one-time)

server-ops-mcp setup --host 1.2.3.4

This will:

• Prompt for your sudo password (hidden input, never stored)
• Create a mcp-agent user on the VPS
• Configure NOPASSWD sudo for service commands
• Generate an Ed25519 SSH keypair
• Save the private key to ~/.ssh/server-ops-<name>
• Update ~/.config/devops-mcp/config.json

3. Add to your MCP client

{
  "mcpServers": {
    "server-ops": {
      "command": "server-ops-mcp"
    }
  }
}

4. Use it

Just talk to your agent:

• "Check disk usage on my server"
• "Restart nginx"
• "Deploy latest code"

The agent discovers and enables tool categories automatically.

Commands

server-ops-mcp                          # Start MCP server (default)
server-ops-mcp setup --host <ip>        # One-time VPS provisioning
server-ops-mcp info                     # Show setup info and management guide
server-ops-mcp info --name my-vps       # Info for a specific host

Configuration

Setup (Recommended)

Use server-ops-mcp setup — handles everything automatically.

Manual Config

Create ~/.config/devops-mcp/config.json:

{
  "hosts": {
    "my-server": {
      "host": "1.2.3.4",
      "username": "mcp-agent",
      "port": 22,
      "key_path": "~/.ssh/server-ops-my-server"
    }
  },
  "default_host": "my-server",
  "enabled_categories": ["ssh", "docker", "utility"],
  "github": {
    "token": "ghp_..."
  }
}

Environment Variables

export DEVOPS_MCP_HOST=1.2.3.4
export DEVOPS_MCP_USER=root
export DEVOPS_MCP_KEY=~/.ssh/id_ed25519
export DEVOPS_MCP_GITHUB_TOKEN=ghp_...

MCP Client Setup

opencode

{
  "mcpServers": {
    "server-ops": {
      "command": "server-ops-mcp"
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "server-ops": {
      "command": "server-ops-mcp"
    }
  }
}

Cursor

{
  "mcpServers": {
    "server-ops": {
      "command": "server-ops-mcp"
    }
  }
}

Security

How it works

1. server-ops-mcp setup runs once in your terminal (not in the agent)
2. Creates a dedicated mcp-agent user on your VPS
3. Configures NOPASSWD sudo for service commands only
4. Generates SSH keypair — private key stays on your machine
5. Password is never stored or passed to the agent

Remove access

# On the VPS
sudo userdel -r mcp-agent
sudo rm /etc/sudoers.d/mcp-agent

Add password to user (if needed later)

# On the VPS
sudo passwd mcp-agent

Rotate SSH key

# On your machine
server-ops-mcp setup --host 1.2.3.4 --name my-vps

Tools (48 total)

Meta-tools (always loaded)

SSH (9 tools)

Docker (6 tools)

Services (7 tools)

Monitoring (6 tools)

GitHub (7 tools)

Deploy (5 tools)

Utility (4 tools)

Development

pip install -e ".[dev]"
ruff check src/
pytest

License

MIT