AgenSysAdmin

MCP server for AI-assisted Linux administration over SSH. Works with OpenAI/Codex, Anthropic, and other MCP-compatible clients to inspect and manage Ubuntu/Debian servers.

The server exposes 21 tools for monitoring, security audits, Docker, service management, backups, package updates, and controlled command execution.

Setup

python -m venv .venv
.venv/Scripts/activate   # Windows
# source .venv/bin/activate  # Linux/Mac
pip install -e ".[dev]"

Related MCP server: vps-mcp

Configuration

1. Copy servers.yaml.example to servers.yaml and edit with your server details.

2. Copy .env.example to .env and set SSH key paths or passwords.

MCP Integration

Run the server with:

python -m agensysadmin

Use that command in any client that supports local MCP servers. Example configuration:

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "sysadmin": {
      "command": "python",
      "args": ["-m", "agensysadmin"],
      "cwd": "D:/AI/AgenSysAdmin"
    }
  }
}

Available Tools

Safety

• Keep servers.yaml, .env, SSH keys, passwords, and production addresses out of version control.

• Prefer read-only inspection tools before mutation tools.

• Require explicit confirmation in your AI client before package installation, service changes, configuration edits, backups, Docker Compose actions, or arbitrary commands.

• Use a dedicated SSH account with the minimum permissions required for each server.

Tests

pytest tests/ -v