Log inSubmit server
Cygnus Ssh MCP logo

Cygnus Ssh MCP

by cygnussystems

Manages remote Linux, macOS, and Windows hosts over SSH through 46 specialized MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Cygnus Ssh MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "cygnussystems-cygnus-ssh-mcp": {
      "command": "uvx",
      "args": [
        "cygnus-ssh-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 46 tools correctly (1mo ago).

Overview

The cygnussystems/cygnus-ssh-mcp MCP server gives MCP-compatible AI clients specialized tools for managing remote Linux, macOS, and Windows systems over SSH. It uses a host configuration file with passwords or SSH keys, optional aliases, and sudo credentials, while using SFTP for file operations that need reliable Unicode handling. Capabilities include remote command execution, line-level file edits, background process control, recursive directory operations, archives, command history, and Windows process inspection. Reach for it when an agent needs structured server administration rather than a single unrestricted command runner; SSH must already be enabled on each target.

Use cases

  • Inspect disk space, memory, uptime, and logs on remote hosts
  • Edit remote configuration files at the line level
  • Launch and monitor background commands
  • Transfer and extract deployment archives
  • Manage Windows processes over SSH

Key features

  • 46 purpose-built SSH administration tools
  • Linux, macOS, and Windows host support
  • Host aliases and TOML-based configuration
  • Sudo operations and SSH key authentication
  • Line-level file editing with SFTP Unicode handling
  • Background task, archive, and recursive directory management

Tools46

What Cygnus Ssh MCP lets your agent do. Expand a tool for its parameters.

Verified live~18.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · cygnus-ssh-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
Last commit29d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed46Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How Cygnus Ssh MCP works

What cygnussystems/cygnus-ssh-mcp MCP server does

The cygnussystems/cygnus-ssh-mcp MCP server exposes 46 purpose-built tools for administering machines reachable through SSH. It supports Linux, macOS, and Windows targets, along with a flex platform type for devices such as routers, NAS systems, and other hosts with non-standard or reduced shells.

Instead of relying on one generic shell tool, the server separates common administration tasks into operations for commands, files, processes, directories, archives, and host management. An MCP-compatible client can use those operations to inspect a host, update a remote configuration file, transfer and extract an artifact, or start work that continues after the initial request.

How it works

The cygnussystems/cygnus-ssh-mcp MCP server runs locally and opens standard SSH connections to hosts defined in a TOML file. Each entry identifies a user and host, plus a port and either a password or private-key file. Optional aliases let clients refer to a machine by a shorter name. A configured sudo password enables privileged operations on Linux and macOS; the regular login password can be reused when applicable.

File content is handled through SFTP where appropriate. This avoids relying on a target shell's console encoding and is intended to preserve non-ASCII text on Windows systems. Background-task tools track the remote process, provide output later, and support termination. The implementation also accounts for platform-specific process identifiers and exit-code behavior.

The target machine must already run an SSH service. The MCP server supplies the management interface, not the SSH daemon itself.

Setup and configuration

Install the package with pip or launch it without a persistent installation through uvx cygnus-ssh-mcp. On its first start, it creates ~/.mcp_ssh_hosts.toml with restrictive permissions when no host file exists. If that path is absent, it can use ./mcp_ssh_hosts.toml instead. Hosts may also be added through the ssh_conn_add_host tool.

A host entry requires a port and either password or keyfile. Supported optional settings include alias, description, sudo_password, and key_passphrase. Key paths can use the home-directory shorthand shown in the project documentation. When key authentication is used without a login password, privileged commands require a separate sudo password or passwordless sudo on the target.

Linux and macOS hosts need SSH enabled. Windows targets require OpenSSH Server, with the README documenting Windows Server 2019+, Windows 10, and Windows 11 as supported environments. Windows Server 2016 and other edge cases have separate guidance.

Tools and capabilities

The cygnussystems/cygnus-ssh-mcp MCP server includes tools for:

  • Running remote commands and retaining command history with output.
  • Executing commands with sudo where the host configuration permits it.
  • Editing individual file lines without a download, local edit, and re-upload cycle.
  • Creating, monitoring, and stopping background tasks.
  • Listing, creating, moving, copying, and removing directories recursively.
  • Creating and extracting archives.
  • Reading and writing files through SFTP for Unicode-safe handling.
  • Connecting to configured hosts by alias.
  • Inspecting processes on Windows SSH targets.

These capabilities fit tasks such as checking system resources and logs, patching configuration files, deploying an archive, restarting a service, or retrieving output from a long-running command.

Limitations and notes

SSH must be installed and running on every target, and the configured account must have the permissions required for requested operations. Sudo support is described for Linux and macOS; Windows administration follows the permissions available to the SSH account.

flex support is still under development. It has been tested with several alternate devices, but behavior may vary across routers, NAS products, embedded systems, and other shells that differ from standard Linux, macOS, or Windows environments.

The project is distributed under GPL version 3. The README identifies Claude Desktop, Claude Code, OpenCode, and other MCP-compatible clients as usable clients; this listing specifically records Claude Desktop among the supported client slugs.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Cygnus Ssh MCP

Run `pip install cygnus-ssh-mcp` for a persistent installation or `uvx cygnus-ssh-mcp` to launch it from uv's isolated cache.

Yes.

Add host entries to `~/.mcp_ssh_hosts.toml`, or use `ssh_conn_add_host`. Each entry needs a port and either a password or key file; aliases and sudo credentials are optional.

Yes. It supports Windows targets using OpenSSH Server, including Windows Server 2019+ and Windows 10/11.

No. SSH must already be installed and running on every target host.

Related MCP servers

All in Command Line All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCygnus Ssh MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/cygnussystems-cygnus-ssh-mcp?style=directory)](https://allmcps.com/mcp/cygnussystems-cygnus-ssh-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/cygnussystems-cygnus-ssh-mcp"><img src="https://allmcps.com/api/badge/cygnussystems-cygnus-ssh-mcp?style=directory" alt="Cygnus Ssh MCP on AllMCPs" /></a>