cygnus-ssh-mcp — Claude Code MCP server: 46 SSH tools
Wires your agent into remote servers over SSH and hands it 46 ready-made tools instead of one generic command runner. Linux, macOS, Windows.
claude mcp add cygnus-ssh-mcp -- uvx cygnus-ssh-mcpWhat cygnus-ssh-mcp does
cygnus-ssh-mcp is an MCP server that turns plain-language requests into actual sysadmin work on remote machines. Hosts are declared up front with aliases, so the agent just names the host it wants. Linux, macOS and Windows targets are all covered, and a flex platform type reaches routers and NAS boxes by probing what each device's shell can do.
The 46 tools split into command execution, sudo, line-level file edits, background processes, command history with output, recursive directory work, and archive create/extract. Windows needed its own fixes: returning a real PID, recovering the exit code that Win32-OpenSSH flattens to 1, and reading files over SFTP because PowerShell mangles non-ASCII stdout.
It does not provide SSH itself. Every target needs an SSH server already running — an optional Windows feature, Remote Login on macOS. The flex path is still a work in progress, so untested hardware will show rough edges.
What it helps with
- check disk, memory and uptime on a remote host
- patch a config file on a server and review the diff
- kick off a long command in the background and collect output later
- inspect running processes on a Windows SSH host
- run something under sudo without orphaning the child process
Example prompts for the agent
- Patch this remote config file and show me what changed.
- Start this in the background and fetch the output later.
How to install cygnus-ssh-mcp
Platform CLI
claude mcp add cygnus-ssh-mcp -- uvx cygnus-ssh-mcpuvx runs the command named after the package; if the README names another one, use uvx --from cygnus-ssh-mcp <command>
Platform CLI
codex mcp add cygnus-ssh-mcp -- uvx cygnus-ssh-mcpuvx runs the command named after the package; if the README names another one, use uvx --from cygnus-ssh-mcp <command>
Config file
{
"mcpServers": {
"cygnus-ssh-mcp": {
"command": "uvx",
"args": [
"cygnus-ssh-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from cygnus-ssh-mcp <command>
Config file
{
"servers": {
"cygnus-ssh-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"cygnus-ssh-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from cygnus-ssh-mcp <command>
Platform CLI
gemini mcp add cygnus-ssh-mcp uvx cygnus-ssh-mcpuvx runs the command named after the package; if the README names another one, use uvx --from cygnus-ssh-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about cygnus-ssh-mcp
How do I install cygnus-ssh-mcp in Claude Code?
Run claude mcp add cygnus-ssh-mcp -- uvx cygnus-ssh-mcp.
What does cygnus-ssh-mcp do?
It links an AI assistant to remote servers over SSH and exposes 46 tools for systems work: commands, sudo, files, background tasks, archives.
What do I need before it works?
An SSH server must already be installed and running on each machine you want to manage — the MCP server does not supply one.
