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]"

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