Cygnus Ssh Mcp

Name: Cygnus Ssh Mcp
Author: cygnussystems

by cygnussystemscommunityv1.5.1

An MCP server that connects AI assistants to remote Linux, macOS, Windows, and some alternate SSH targets over SSH, exposing purpose-built tools for server administration. It supports host aliases, sudo, background process management, file editing, transfers, and other real-world SSH operations.

From the registry: SSH-based MCP control of remote Linux, macOS, and Windows servers -- 46 purpose-built tools.

GitHub Repository

Install & configure

Prerequisites

required
Install and enable SSH server on target machines
Each remote server you want to manage must already be running an SSH server. The README provides platform-specific setup for Linux, macOS, and Windows targets.
required
Install uv (for the preferred uvx launch method)
The simplest portable launch path is `uvx cygnus-ssh-mcp`, which requires `uv` to be installed first.
https://docs.astral.sh/uv/
required
Create SSH host configuration file
On first start, the server auto-creates an empty host config file at `~/.mcp_ssh_hosts.toml` if none exists. Populate it with your SSH hosts and credentials, or point the server to a custom file with `--config <path-to-hosts.toml>`.

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `cygnus-ssh-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install and enable SSH server on target machines** — Each remote server you want to manage must already be running an SSH server. The README provides platform-specific setup for Linux, macOS, and Windows targets.
- **Install uv (for the preferred uvx launch method)** — The simplest portable launch path is `uvx cygnus-ssh-mcp`, which requires `uv` to be installed first. (https://docs.astral.sh/uv/)
- **Create SSH host configuration file** — On first start, the server auto-creates an empty host config file at `~/.mcp_ssh_hosts.toml` if none exists. Populate it with your SSH hosts and credentials, or point the server to a custom file with `--config <path-to-hosts.toml>`.

Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["cygnus-ssh-mcp"]

Note: Optional stdio argument: `--config <path-to-hosts.toml>` to use a custom host configuration file, e.g. command `uvx` with args `["cygnus-ssh-mcp", "--config", "<path-to-hosts.toml>"]`. If installed via pip instead of uvx, the command becomes `cygnus-ssh-mcp` with optional args `["--config", "<path-to-hosts.toml>"]`. No MCP env vars are documented.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Optional stdio argument: `--config <path-to-hosts.toml>` to use a custom host configuration file, e.g. command `uvx` with args `["cygnus-ssh-mcp", "--config", "<path-to-hosts.toml>"]`. If installed via pip instead of uvx, the command becomes `cygnus-ssh-mcp` with optional args `["--config", "<path-to-hosts.toml>"]`. No MCP env vars are documented.