{ "markdown": "\n
\n\n\"cygnus-ssh-mcp\"\n\n# cygnus-ssh-mcp\n\n**Cross-platform SSH MCP server with 46 purpose-built tools for real server management by AI agents**\n\n[![PyPI version](https://img.shields.io/pypi/v/cygnus-ssh-mcp.svg)](https://pypi.org/project/cygnus-ssh-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/cygnus-ssh-mcp.svg)](https://pypi.org/project/cygnus-ssh-mcp/)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Tests](https://img.shields.io/badge/tests-145%2B%20passing-brightgreen.svg)]()\n\n*Give Claude, OpenCode, or any MCP-compatible AI assistant full control of your\nLinux, macOS, and Windows servers with 46 specialized tools*\n\n[Prerequisites](#prerequisites-ssh-on-your-target-servers) · [Installation](#installation) · [Quick Start](#quick-start) · [Features](#features) · [Documentation](https://cygnussystems.github.io/cygnus-ssh-mcp/)\n\n
\n\n---\n\n> [!TIP]\n> **A note from the author:** I've been running this daily since April 2025 — over a\n> year now — to manage a dozen+ machines and devices, plus a Proxmox host running\n> 30+ containers, across a network tied together with Tailscale. It started as a\n> tool to solve my own problem, and it's saved me a huge amount of manual work ever\n> since. After a year of running it against Linux, I've since added support for\n> Windows, macOS, and other devices with reduced shells like BusyBox. I'm\n> open-sourcing it now because I think anyone running real infrastructure will find\n> it just as useful. This is a young *public* repo, but the tool behind it isn't new\n> or unproven — it's been battle-tested against my own servers for over a year.\n>\n> If you find it useful, a ⭐ star or a mention to someone who manages their own\n> infrastructure goes a long way for a project this new — thank you!\n\n---\n\n## Why cygnus-ssh-mcp?\n\n**cygnus-ssh-mcp is an MCP server - usable from Claude Desktop, Claude Code,\nOpenCode, or any other MCP-compatible client - that connects your AI assistant\ndirectly to your remote servers over SSH, exposing 46 purpose-built tools instead\nof one generic command-runner.** It turns natural-language requests into real\nsystems administration - connecting by alias, editing files, managing background\nprocesses, handling sudo - across Linux, macOS, and Windows targets alike.\n\nDoing that properly means solving a pile of genuinely hard, per-platform problems\nthat a naive `ssh` wrapper never has to face - and that this project hit and fixed\nthe hard way, including:\n\n- Getting a *real* PID back from a Windows target, instead of a meaningless local channel number\n- Recovering the actual exit code when Win32-OpenSSH silently flattens it to `1`\n- Reading file contents via SFTP instead of `Get-Content`, because PowerShell's console encodes stdout in its OEM code page and corrupts anything non-ASCII\n- Killing a `sudo`'d background process without leaving its privileged child orphaned or blindly firing SIGKILL at the wrong PID\n\nNone of this shows up until you actually run these tools against real Linux, macOS,\nand Windows targets under real conditions - which is exactly how every one of these\nwas found and fixed here, not guessed at from documentation.\n\n| What you get | Basic SSH MCP | cygnus-ssh-mcp |\n|--------------|:-------------:|:--------------:|\n| Run commands | ✅ | ✅ |\n| Pre-configured hosts with aliases | ❌ | ✅ |\n| Sudo support (Linux/macOS) | Limited | ✅ |\n| Windows Server support | ❌ | ✅ |\n| Background task management | ❌ | ✅ |\n| Line-level file editing | ❌ | ✅ |\n| Command history with output | ❌ | ✅ |\n| Recursive directory operations | ❌ | ✅ |\n| Archive create/extract | ❌ | ✅ |\n| Full Unicode support | Varies | ✅ |\n\nBeyond Linux, macOS, and Windows, cygnus-ssh-mcp can also reach further -\nrouters, NAS boxes, and other non-standard SSH targets connect too, via a\n`flex` platform type and a capability probe that detects what each device's\nshell can actually do. See [Connecting to Alternate Platforms](#connecting-to-alternate-platforms) below.\n\n> [!WARNING]\n> **Alternate-platform (`flex`) support is a work in progress.** It's been\n> verified against several real devices, but the space of routers/NAS/embedded\n> systems is huge - expect rough edges on hardware that hasn't been tried yet.\n\n### Example agent tasks\n\nAsk your MCP-capable agent to:\n\n- \"Check disk space, memory, uptime, and recent logs on my `web` host.\"\n- \"Patch this remote config file safely and show me the diff.\"\n- \"Upload this build artifact, extract it, and restart the service.\"\n- \"Start this command in the background and fetch the output later.\"\n- \"Inspect running processes on my Windows SSH host.\"\n\n---\n\n## Prerequisites: SSH on Your Target Servers\n\ncygnus-ssh-mcp connects over standard SSH - it doesn't provide SSH itself, so each\nserver you want to manage needs an SSH server already installed and running.\n\n**Linux** - usually pre-installed on server distros; if not:\n```bash\nsudo apt install openssh-server # Debian/Ubuntu\nsudo systemctl enable --now ssh\n```\n\n**macOS** - enable Remote Login in System Preferences → Sharing, or from the terminal:\n```bash\nsudo systemsetup -setremotelogin on\n```\n\n**Windows** (Server 2019+, or Windows 10/11) - OpenSSH Server is an optional feature:\n```powershell\nAdd-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0\nStart-Service sshd\nSet-Service -Name sshd -StartupType 'Automatic'\n```\nSee [Windows Support](docs/25-windows-support.md) for Windows Server 2016 and other edge cases.\n\n---\n\n## Installation\n\nPick **one** of the two options below - they're independent tools that don't share\nstorage, so commands from one won't see or affect what the other did.\n\n### Option A: pip (a persistent install)\n\n```bash\npip install cygnus-ssh-mcp\n```\n\nUninstalling or upgrading:\n\n```bash\npip uninstall cygnus-ssh-mcp\npip install --upgrade cygnus-ssh-mcp\n```\n\n### Option B: uvx (no install at all)\n\n> [!NOTE]\n> **What's `uvx`?** It's part of [`uv`](https://docs.astral.sh/uv/) (a fast Python\n> package manager) - `uvx ` downloads a package into a disposable,\n> isolated cache and runs it immediately, without installing it into your system\n> Python, a project, or anywhere `pip` can see. Nothing lingers afterward for you\n> to manage. It's the easiest option if you just want your MCP client to launch\n> this server without thinking about Python environments at all.\n\n```bash\nuvx cygnus-ssh-mcp\n```\n\nThere's nothing to \"uninstall\" - `uvx` re-resolves and re-fetches the latest\nversion on every run anyway. To force a fresh fetch or clear its cache instead:\n\n```bash\nuvx --refresh cygnus-ssh-mcp # force this run to ignore the cache\nuv cache clean # clear uv's entire package cache\n```\n\nIf you want a `uvx`-style setup that *does* persist (so it doesn't re-fetch every\ntime) and can be upgraded deliberately, use `uv tool install cygnus-ssh-mcp`\ninstead - manage that with `uv tool uninstall cygnus-ssh-mcp` / `uv tool upgrade\ncygnus-ssh-mcp`. This is still separate from `pip` (Option A) - don't mix `pip`\ncommands with anything set up via `uv`/`uvx`, they can't see each other.\n\n---\n\n## Quick Start\n\n### 1. Add your hosts\n\nYou don't need to create anything by hand - the first time the server starts, it\nautomatically creates an empty host config file at `~/.mcp_ssh_hosts.toml` (secure\n`0o600` permissions) if nothing is there yet. Just open that file (or use\n`ssh_conn_add_host` from within your AI assistant) and add entries like:\n\n```toml\n# Minimal (password auth) - only required fields\n[\"user@server.example.com\"]\npassword = \"your_password\"\nport = 22\n\n# With alias and sudo (most common setup)\n[\"admin@production.example.com\"]\npassword = \"your_password\"\nport = 22\nsudo_password = \"sudo_pass\" # optional: for use_sudo operations\nalias = \"prod\" # optional: connect by alias\ndescription = \"Production server\" # optional: for documentation\n\n# SSH key authentication\n[\"deploy@staging.example.com\"]\nkeyfile = \"~/.ssh/id_ed25519\"\nport = 22\nalias = \"staging\"\n\n# Windows Server (requires OpenSSH)\n[\"administrator@winserver.example.com\"]\npassword = \"your_password\"\nport = 22\nalias = \"win-prod\"\n```\n\n**Required fields:** `port` + (`password` OR `keyfile`)\n**Optional fields:** `alias`, `description`, `sudo_password`, `key_passphrase`\n\n`sudo_password` is optional if your account uses password auth - when omitted, the\nregular `password` is reused for `use_sudo` operations too. It's only required if\nyour sudo password differs from your login password, or if you're using SSH key\nauth (`keyfile`) with no `password` field at all - in that case, either set\n`sudo_password` explicitly or configure passwordless sudo on the server.\n\n> [!TIP]\n> **Host file locations:** Default is `~/.mcp_ssh_hosts.toml`. Falls back to `./mcp_ssh_hosts.toml` if not found.\n> Use `--config /path/to/hosts.toml` for a custom location. If a file already exists\n> at whichever path is used, it is **never** overwritten or reset - auto-creation\n> only ever happens when nothing is there yet.\n\n> [!WARNING]\n> **Watch for hidden file extensions.** If you create this file yourself in Notepad\n> or TextEdit, Windows and macOS both hide known extensions by default - a file you\n> named `mcp_ssh_hosts.toml` can silently actually be saved as\n> `mcp_ssh_hosts.toml.txt`, and the server will never find it. Turn on \"show file\n> extensions\" in Explorer/Finder, or verify from a terminal:\n> `ls -la ~/.mcp_ssh_hosts.toml*` (macOS/Linux) or\n> `dir %USERPROFILE%\\.mcp_ssh_hosts.toml*` (Windows) - either should show exactly\n> one file, with no extra extension after `.toml`.\n\n### 2. Add to your MCP client\n\nMost MCP clients (Claude Desktop, Claude Code, OpenCode, Cursor, Cline, Windsurf,\nand others) use the same `mcpServers` JSON shape shown below - only the config\nfile's name and location differ per client. Claude Desktop is used as the concrete\nexample here; see the Claude Code note further down for one client that differs,\nor check your own client's docs for its config file's path.\n\n> [!WARNING]\n> **Python must be on `PATH` for `\"command\": \"cygnus-ssh-mcp\"` (below) to work at\n> all.** This is the most common reason an MCP client fails to start the server\n> (or the tool list never appears) - and with Python often installed in several\n> different places on one machine, it's easy to hit. Check first with:\n> ```bash\n> python --version # Windows/macOS/Linux\n> python3 --version # macOS/Linux, if the above isn't found\n> ```\n> If that fails with \"not recognized\"/\"command not found\", Python isn't on `PATH` -\n> fix that first (reinstall Python with \"Add to PATH\" checked on Windows, or add it\n> to your shell profile), or work around it entirely by finding the full path to\n> the installed executable instead: `where cygnus-ssh-mcp` (Windows) or\n> `which cygnus-ssh-mcp` (macOS/Linux), then use that directly as `command`:\n> ```json\n> {\n> \"mcpServers\": {\n> \"ssh\": {\n> \"command\": \"C:\\\\Users\\\\yourname\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python312\\\\Scripts\\\\cygnus-ssh-mcp.exe\",\n> \"args\": [\"--config\", \"C:\\\\Users\\\\yourname\\\\.mcp_ssh_hosts.toml\"]\n> }\n> }\n> }\n> ```\n\nFor Claude Desktop, edit `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"ssh\": {\n \"command\": \"cygnus-ssh-mcp\"\n }\n }\n}\n```\n\nOr with a custom hosts file location:\n\n```json\n{\n \"mcpServers\": {\n \"ssh\": {\n \"command\": \"cygnus-ssh-mcp\",\n \"args\": [\"--config\", \"/path/to/my_hosts.toml\"]\n }\n }\n}\n```\n\nOn Windows, use an absolute path with **escaped** backslashes (JSON needs `\\\\`, not\na single `\\`):\n\n```json\n{\n \"mcpServers\": {\n \"ssh\": {\n \"command\": \"cygnus-ssh-mcp\",\n \"args\": [\"--config\", \"C:\\\\Users\\\\yourname\\\\.mcp_ssh_hosts.toml\"]\n }\n }\n}\n```\n\n**Using [Claude Code](https://claude.com/claude-code) instead of Claude Desktop?**\nIt reads its own project-level `.mcp.json` file (in your project root) rather than\n`claude_desktop_config.json`, and its schema supports a couple of extra fields\nDesktop doesn't have:\n\n```json\n{\n \"mcpServers\": {\n \"cygnus_ssh\": {\n \"command\": \"cygnus-ssh-mcp\",\n \"args\": [\"--config\", \"/path/to/.mcp_ssh_hosts.toml\"],\n \"working_dir\": \"/path/to/your/project\",\n \"auto_start\": true\n }\n }\n}\n```\n\n- **`working_dir`** - the directory the server process runs from. Claude Desktop\n has no equivalent - it doesn't expose a configurable working directory at all,\n which is exactly why the Desktop examples above always use absolute paths.\n- **`auto_start`** - whether Claude Code starts this server automatically. Claude\n Desktop always auto-starts every configured server; there's no toggle for it.\n\nEverything else - the `--config` argument, and the PATH/backslash caveats from the\nwarning above - applies the same way to both clients.\n\n### 3. Start managing servers\n\n> [!NOTE]\n> `PROD` in the examples below is just an example **alias** (`alias = \"prod\"` in the\n> hosts file from step 1) - it's not a magic name. If a host doesn't have an alias\n> configured, refer to it by its full `user@host` key instead, e.g. \"Connect to\n> admin@203.0.113.10 and...\" or \"Connect to deploy@myserver.example.com and...\".\n>\n> Depending on which LLM/client you're using, it may not automatically realize it\n> should reach for this MCP server - if it tries to answer without connecting, or\n> claims it can't access remote servers, explicitly tell it to use the SSH MCP\n> tools (e.g. \"use the ssh MCP to connect to PROD and...\").\n\nJust say:\n\n> \"Connect to PROD and tell me about the machine - hardware, status, everything\"\n\n> \"Connect to the GPU box and tell me how many graphics cards it has and how much\n> total VRAM\"\n\n> \"Edit /etc/nginx/nginx.conf and change worker_connections to 2048\"\n\n> \"Find all .log files larger than 100MB in /var/log\"\n\nIt handles multi-step jobs just as easily - install packages, edit configs, open\nfirewall ports, and restart services, all in one request:\n\n> \"Install PostgreSQL, set it to listen on all interfaces, add a pg_hba.conf rule\n> for remote connections, open port 5432 in the firewall, and create a database\n> called analytics\"\n\n> \"Set up a full LAMP stack, download the latest WordPress, configure\n> wp-config.php with a new database, and get the site running at\n> /var/www/wordpress\"\n\n> \"Get a Let's Encrypt certificate for example.com, configure nginx to serve it\n> over HTTPS, and redirect all HTTP traffic to it\"\n\n> \"My Node app in /opt/api keeps crashing - check the logs, find out why, and set\n> it up as a systemd service that restarts automatically\"\n\n> \"Audit PROD's security - check what ports are open, what's actually listening on\n> them, whether the firewall rules match, and flag anything that looks like it\n> shouldn't be exposed to the internet\"\n\n---\n\n## Platform Support\n\ncygnus-ssh-mcp works from **any client** (Windows, Linux, macOS) to **any target server**:\n\n
\n\"Platform\n
\n\n| From (Client) | To (Target) | Status |\n|---------------|-------------|--------|\n| Windows | Linux | ✅ Tested |\n| Windows | Windows | ✅ Tested |\n| Linux | Linux | ✅ Tested |\n| Linux | Windows | ✅ Tested |\n| macOS | Any | ✅ Supported |\n\n**Windows targets** require OpenSSH Server installed and running.\n\n---\n\n## Connecting to Alternate Platforms\n\n> [!WARNING]\n> **This is a work in progress.** It's been verified against several real\n> devices below, but routers/NAS/embedded systems vary enormously - expect to\n> hit devices that don't work yet, and please open an issue if you do.\n\nBeyond Linux, macOS, and Windows, cygnus-ssh-mcp connects to **any SSH target\nthat responds to a basic shell command** - routers, NAS boxes, BSD-kernel\nappliances, and other embedded Linux devices. These report `os_type: \"flex\"`.\n\nOn connect, a one-time capability probe checks the specific shell/coreutils\nfeatures this project's tools depend on (GNU `find -printf`, `stat -c`, `du\n-sb`, `tar --strip-components`, `ps -o pgid=`, `xargs -0`, and more) - many\nembedded/BusyBox-based devices only support a smaller flag set than full GNU\ncoreutils. The results come back from `ssh_conn_connect` as `capabilities`\nand, for anything missing, `capability_warnings`. A tool that needs a missing\ncapability fails with a clear error naming exactly what's unavailable and,\nwhere one exists, a concrete fallback - nothing silently degrades.\n\n**Verified against:**\n\n| Device | Result |\n|---|---|\n| Alpine Linux (BusyBox) | Connects as `linux`; no `bash`/GNU `find`/`ps -o pgid=` - gated tools fail with clear fallback messages, everything else works |\n| OpenWrt | Connects as `linux`; root-only, most GNU extensions absent |\n| FreeBSD | Connects as `flex`; no `bash` by default, sudo/task tooling adapted to use `sh` |\n| Synology DSM (NAS) | Connects as `linux`; full GNU coreutils and working `sudo` - behaves like a normal Linux server |\n\n**Known limitation:** some devices reject SSH shell access entirely for an\naccount, even one with admin-level permissions - this shows up as every\ncommand (even a bare `echo`) failing immediately after a successful login. No\ncapability probe can fix that; `ssh_conn_connect` explains the situation\nin that failure rather than a generic error.\n\nFull details, capability list, and current gaps:\n[docs/26-alternate-platforms.md](docs/26-alternate-platforms.md).\n\n---\n\n## Features\n\n### Host Configuration\n\nStop typing credentials. Connect by alias.\n\n```toml\n[\"admin@server.com\"]\npassword = \"secret\"\nport = 22\nalias = \"web\"\n```\n\nThen just: *\"Connect to WEB\"*\n\nSupports **password**, **SSH key**, and **encrypted keys with passphrase**.\n\nUpdate a field on an existing host without losing the rest (`ssh_host_update`), or\nswitch every host tool to an alternate config file for the session\n(`ssh_host_use_config`) - handy for keeping separate host lists per project or\nenvironment.\n\n---\n\n### Line-Level File Editing\n\nEdit config files with surgical precision—no download/upload needed.\n\n```python\n# Replace a single line\nssh_file_replace_line(\n file_path=\"/etc/nginx/nginx.conf\",\n match_line=\"worker_connections 1024;\",\n new_line=\"worker_connections 4096;\"\n)\n\n# Insert lines after a match\nssh_file_insert_lines_after_match(\n file_path=\"/etc/hosts\",\n match_line=\"# Custom entries\",\n lines_to_insert=[\"192.168.1.10 app.local\", \"192.168.1.11 db.local\"]\n)\n```\n\n**Safety built-in**: Operations fail if the match isn't unique—no accidental mass edits.\n\n---\n\n### Background Task Management\n\nLaunch long-running processes and check back later.\n\n```python\n# Start a backup (returns immediately)\nssh_task_launch(command=\"./backup.sh\", stdout_log=\"/var/log/backup.log\")\n\n# Check status anytime\nssh_task_status(pid=12345) # → 'running' or 'exited'\n\n# Kill if needed\nssh_task_kill(pid=12345, force=True)\n```\n\n---\n\n### Comprehensive Sudo Support\n\nEvery tool supports `use_sudo`. Password is handled automatically.\n\n```python\nssh_file_write(file_path=\"/etc/app/config.yaml\", content=\"...\", use_sudo=True)\nssh_dir_mkdir(path=\"/opt/myapp\", use_sudo=True)\nssh_archive_extract(archive_path=\"/backup.tar.gz\", destination_path=\"/\", use_sudo=True)\n```\n\n---\n\n### Three-Way Timeout System\n\nNever get stuck on a hanging command - and never lose track of a long one either.\n\n```python\nssh_cmd_run(\n command=\"./long_script.sh\",\n io_timeout=60.0, # Check back in if silent for 60s (does NOT kill it)\n wait_timeout=20.0, # Or check back in every 20s regardless of activity\n runtime_timeout=3600.0 # Hard safety cap - the only one that actually kills it\n)\n```\n\n`io_timeout` and `wait_timeout` never kill the remote command - they hand off to\nbackground monitoring so you can check back later (`ssh_cmd_check_status`), read\noutput collected so far (`ssh_cmd_output`), or decide to end it early\n(`ssh_cmd_kill`). Only `runtime_timeout` ever terminates anything.\n\n---\n\n### Full Unicode Support\n\nWrite and read files with emojis, international text, and special characters—on **all platforms**.\n\n```\n✅ ❌ 🎉 • → ≥ ∞ │ ┌ ─ 你好 مرحبا Привет café naïve\n```\n\n**How it works:** `ssh_file_read` and `ssh_file_write` use SFTP for direct binary transfer, completely bypassing shell encoding issues. This means Unicode works perfectly even on Windows targets where PowerShell's console encoding would normally corrupt special characters.\n\n---\n\n### Windows Server Support\n\nFull support for Windows targets with OpenSSH Server:\n\n- **PowerShell & CMD** command execution\n- **Windows path handling** (backslashes, drive letters, UNC paths)\n- **Administrator detection** — shows if session has elevated privileges\n- **SFTP-based file operations** — Unicode-safe, no encoding issues\n\nNote: `use_sudo` is ignored on Windows (no sudo equivalent). For elevated operations, connect with an Administrator account.\n\n---\n\n### And Much More...\n\n- **Command history** with output retention and pattern filtering\n- **Recursive directory operations**: search, copy, delete with dry-run\n- **Archive operations**: create and extract tar.gz\n- **System info**: OS version, memory, disk, CPU, uptime\n- **Pattern search**: regex and plain text in files\n- **Alternate host config files**: switch host lists per project/environment without restarting\n\n---\n\n## All 46 Tools\n\n### Connection & Host Management (12 tools)\n\n| Tool | Description |\n|------|-------------|\n| `ssh_conn_connect` | Connect using pre-configured host (by key or alias) |\n| `ssh_conn_is_connected` | Check if SSH connection is active |\n| `ssh_conn_status` | Get connection status (user, host, OS, cwd) |\n| `ssh_conn_host_info` | Get detailed system information |\n| `ssh_conn_verify_sudo` | Verify sudo access |\n| `ssh_conn_add_host` | Add new host to configuration |\n| `ssh_host_list` | List all configured hosts |\n| `ssh_host_update` | Update fields on an existing host (rotate password, change port, etc.) in place |\n| `ssh_host_remove` | Remove host from configuration |\n| `ssh_host_use_config` | Switch to an alternate host config file for the session |\n| `ssh_host_disconnect` | Disconnect current session |\n| `list_tools` | List all available tools |\n\n### Command Execution (6 tools)\n\n| Tool | Description |\n|------|-------------|\n| `ssh_cmd_run` | Execute command with I/O, wait, and runtime timeouts |\n| `ssh_cmd_kill` | Terminate running command |\n| `ssh_cmd_check_status` | Check command status |\n| `ssh_cmd_output` | Retrieve output from command |\n| `ssh_cmd_history` | Get command history with filtering |\n| `ssh_cmd_clear_history` | Clear command history |\n\n### Background Tasks (3 tools)\n\n| Tool | Description |\n|------|-------------|\n| `ssh_task_launch` | Launch command in background |\n| `ssh_task_status` | Check if task is running |\n| `ssh_task_kill` | Send signal to task |\n\n### File Operations (12 tools)\n\n| Tool | Description |\n|------|-------------|\n| `ssh_file_stat` | Get file metadata |\n| `ssh_file_read` | Read file contents via SFTP (Unicode-safe) |\n| `ssh_file_write` | Create/overwrite/append file |\n| `ssh_file_copy` | Copy file |\n| `ssh_file_move` | Move or rename file |\n| `ssh_file_transfer` | Upload or download files |\n| `ssh_file_find_lines_with_pattern` | Search for pattern in file |\n| `ssh_file_get_context_around_line` | Get context around match |\n| `ssh_file_replace_line` | Replace single line |\n| `ssh_file_replace_line_multi` | Replace with multiple lines |\n| `ssh_file_insert_lines_after_match` | Insert lines after match |\n| `ssh_file_delete_line_by_content` | Delete line by content |\n\n### Directory Operations (11 tools)\n\n| Tool | Description |\n|------|-------------|\n| `ssh_dir_mkdir` | Create directory |\n| `ssh_dir_remove` | Remove directory |\n| `ssh_dir_list_files_basic` | Basic directory listing |\n| `ssh_dir_list_advanced` | Recursive listing with metadata |\n| `ssh_dir_search_glob` | Search files by pattern |\n| `ssh_dir_search_files_content` | Search text in files |\n| `ssh_dir_calc_size` | Calculate directory size |\n| `ssh_dir_delete` | Delete with dry-run support |\n| `ssh_dir_batch_delete_files` | Batch delete by pattern |\n| `ssh_dir_copy` | Copy directory recursively |\n| `ssh_dir_transfer` | Upload or download whole directories (archive-based) |\n\n### Archive Operations (2 tools)\n\n| Tool | Description |\n|------|-------------|\n| `ssh_archive_create` | Create tar.gz archive |\n| `ssh_archive_extract` | Extract archive |\n\n---\n\n## Documentation\n\n**Full docs site: [cygnussystems.github.io/cygnus-ssh-mcp](https://cygnussystems.github.io/cygnus-ssh-mcp/)**\n— searchable, with navigation. Or browse the raw files directly in [docs/](docs/):\n\n- [Overview](docs/10-overview.md)\n- [Installation](docs/15-installation.md)\n- [Platform Compatibility](docs/20-platform-compatibility.md)\n- [Windows Support](docs/25-windows-support.md)\n- [Alternate Platforms (flex)](docs/26-alternate-platforms.md)\n- [Host Configuration](docs/30-host-configuration.md)\n- [Tools Reference](docs/40-tools-reference.md)\n- [Command Execution](docs/50-command-execution.md)\n- [Process Management](docs/60-process-management.md)\n- [Logging](docs/70-logging.md)\n- [Claude Desktop Setup](docs/80-claude-desktop.md)\n\n---\n\n## Use Cases\n\n- **DevOps Automation** — Deploy, configure, and manage servers via AI\n- **Log Analysis** — Search and analyze logs across multiple servers\n- **Configuration Management** — Edit configs with precision line operations\n- **Backup & Recovery** — Create archives, transfer files, restore backups\n- **System Monitoring** — Check status, verify services, monitor processes\n- **Security Auditing** — Search for sensitive patterns, verify configurations\n\n---\n\n## License\n\n[GPL-3.0](LICENSE) — Free and open source.\n\n---\n\n
\n\n**Built by [Cygnus Systems](https://github.com/cygnussystems)**\n\n*Star this repo if you find it useful!*\n\n
\n", "bytes": 25944, "sha": "2a457d70e6a26d2cc657be258eef5689e7803d3619f72be08c04f5838d76674b", "repo_slug": "cygnussystems/cygnus-ssh-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_cygnussystems_cygnus_ssh_mcp_f51746f7/readme" }