Python 3.10+ | Textual UI

A modern TUI for
Managing Servers

SSH, SCP, CloudTrail scanning, and AI log analysis right from your terminal. Built with Textual and integrated with an MCP server for AI agents like Claude Code.

bash
$ pipx install servonaut
$ servonaut # Launch TUI
All Install Options
Servonaut AI Assistant
MCP Server Online
{{ msg.text }}

Command your Infrastructure

Manage AWS EC2, custom servers, and logs without leaving the terminal.

Interactive TUI

Mouse and keyboard support powered by Textual. List, search, SSH into instances, and transfer files via SCP seamlessly.

> Press 'S' to SSH
> Press 'T' for SCP

MCP Server & AI Analysis

Analyze live logs using OpenAI, Anthropic, or Ollama. Expose tools to AI agents (like Claude Code) via the built-in MCP server.

$ servonaut --mcp-install

AWS Native Tools

Browse CloudTrail events, analyze CloudWatch logs, and ban malicious IPs via WAF, Security Groups, or NACLs directly from the TUI.

> CloudTrail Explorer
> WAF Manager

AI-Powered Server Management

Give your AI agents direct access to your infrastructure via the Model Context Protocol.

Servonaut ships with a built-in MCP server. One command installs it into Claude Code, giving AI agents read and write access to your servers through structured, auditable tool calls.

Works with Claude Code, Cursor, Windsurf, and any other MCP-compatible client. Guard levels (readonly, standard, dangerous) let you control exactly what the AI can touch.

Install MCP server
$ servonaut --mcp-install
Log Analysis

Surface errors and anomalies across all your servers in seconds.

CloudTrail & WAF

Browse CloudTrail events and manage WAF rules from a guided flow, with every change audited.

Natural Language Commands

Describe what you want. The AI figures out which tools to call.

Claude Code + Servonaut MCP
> Claude, check my server logs for errors
→ Calling get_logs(server="prod-1", lines=100)
→ Found 3 critical errors in nginx.log
→ Analyzing patterns...

> Deploy the fix to staging
→ Calling run_command(server="staging", cmd="git pull && restart")
→ Deployment complete. Service healthy.

> Scan CloudTrail for suspicious activity
→ Calling scan_cloudtrail(hours=24, severity="high")
→ 2 unusual IAM events detected from 203.0.113.42
→ Calling ban_ip(ip="203.0.113.42", method="waf")
→ IP banned. WAF rule created.

Up and running in minutes

No agents to configure, no infrastructure to provision. Just install and go.

01

Install

$ pipx install servonaut

One command. No dependencies to wrangle. Works on Linux, macOS, and Windows.

02

Configure

Point to your servers. Servonaut auto-discovers AWS EC2 instances via your configured AWS CLI profile. Custom servers from any provider slot in via ~/.servonaut/config.json.

AWS EC2 Hetzner DigitalOcean On-Prem
03

Manage

SSH, deploy, analyze logs, audit CloudTrail, and manage WAF rules — all from your terminal. Or let your AI agent handle it via MCP.

SSH SCP CloudTrail WAF

Built for modern infrastructure teams

Open Source MIT Licensed Python 3.10+ MCP Tools for AI Agents
GitHub Stars

Ready to level up?

The CLI is free and open source. Upgrade for cloud config sync and a hosted MCP server for your AI agents.

View Pricing Star on GitHub

Quick Installation

Install Options
# 1. Linux / macOS auto-installer
curl -sSL https://raw.githubusercontent.com/zb-ss/ec2-ssh/master/install.sh | bash

# 2. Windows (PowerShell)
irm https://raw.githubusercontent.com/zb-ss/ec2-ssh/master/install.ps1 | iex

# 3. Pipx (Recommended for isolated install)
pipx install servonaut
# Optional AI and MCP dependencies
pipx inject servonaut httpx mcp

Requires Python 3.10+, an SSH client, and AWS CLI configured.