# Ssh Fleet MCP Server

> Ssh Fleet MCP Server is an MCP server for developer tools. MCP server that runs commands and tmux sessions on a fleet of SSH hosts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/jordanburke/ssh-client-mcp-server
- **MCP Registry name:** io.github.jordanburke/ssh-fleet-mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-15

## About

Built on the somamcp framework, this fleet server keeps pooled SSH connections to several hosts and routes each call to the host you name. Its hosts are defined in a TOML fleet config, and a `fleet_setup` step, an audit log, a policy layer and a certificate-authority mode are covered in the orchestrator README.

The tool set centres on a shell `exec` that returns stdout and stderr with clear exit-code markers, plus tmux-backed tools for driving long-running interactive processes such as a remote coding agent. tmux must be installed on the target host, and the account needs a POSIX login shell such as sh, bash or zsh.

The repository also ships a single-host sibling package, `ssh-client-mcp-server`, which supports password, key file, key-from-environment and ssh-agent authentication. It runs from Linux, macOS or Windows on Node 22 or newer.

## Features

- **Host-routed exec:** Runs a shell command on a chosen host and reports exit codes and signals.
- **Persistent tmux sessions:** List, type into, read and send control keys to tmux sessions across calls.
- **Pooled connections:** Reuses SSH connections across the fleet instead of reconnecting per call.
- **Several auth modes:** The single-host sibling supports password, key file, key from env var and ssh-agent.
- **Fail-fast validation:** Key and config problems are reported at startup and in tool errors.

## Good for

- Run maintenance commands on many servers from one assistant
- Drive a remote coding agent that lives in a tmux session
- Check logs on several hosts without opening separate terminals
- Operate macOS and Linux machines from a single hub

## Install

### Claude Code (Terminal)

```sh
claude mcp add ssh-fleet-mcp-server -- npx -y ssh-fleet-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ssh-fleet-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-fleet-mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ssh-fleet-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-fleet-mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ssh-fleet-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ssh-fleet-mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ssh-fleet-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-fleet-mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ssh-fleet-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-fleet-mcp-server"
      ]
    }
  }
}
```

## Tools

- `exec`: Run a shell command on a remote host and return its output.
- `tmux_list`: List live tmux sessions.
- `tmux_send`: Type input into a tmux session, creating it if absent.
- `tmux_read`: Return the recent pane transcript of a session.
- `tmux_keys`: Send control or special keys to a session.
- `fleet_setup`: Set up the fleet configuration.

## FAQ

### What does tmux_read return?

The recent pane transcript of a session; lines default to 200 with a maximum of 2000.

### What does the remote account need?

A POSIX login shell such as sh, bash or zsh for the tmux tools, and tmux installed on the host.

### Which runtime is required?

Node 22 or newer, on Linux, macOS or Windows.

### How do I install it?

Launch it with npx from your MCP client, so no global install is needed.

### How do I add Ssh Fleet MCP Server to Claude Code?

Run this command in your terminal: claude mcp add ssh-fleet-mcp-server -- npx -y ssh-fleet-mcp-server

### What are the best alternatives to Ssh Fleet MCP Server?

The closest alternatives to Ssh Fleet MCP Server are MCP Ssh Manager, SSH MCP Server, VPS MCP & Digital Secretary, Tailscale MCP and MCP Server Filesystem.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [MCP Ssh Manager](https://ai-powered.com/mcp/mcp-ssh-manager): MCP Ssh Manager is an open-source MCP server for developer tools.
- [SSH MCP Server](https://ai-powered.com/mcp/ssh-mcp-server-2): SSH MCP Server is an open-source MCP server for developer tools.
- [VPS MCP & Digital Secretary](https://ai-powered.com/mcp/vps-mcp-and-digital-secretary): VPS MCP & Digital Secretary is an open-source MCP server for cloud and infrastructure.
- [Tailscale MCP](https://ai-powered.com/mcp/tailscale-mcp): Tailscale MCP is an open-source MCP server for cloud and infrastructure.
- [MCP Server Filesystem](https://ai-powered.com/mcp/mcp-server-filesystem): MCP Server Filesystem is an open-source MCP server for files and documents.
- [Linux MCP daemon (mcpd)](https://ai-powered.com/mcp/linux-mcp-daemon-mcpd): Linux MCP daemon (mcpd) is an open-source MCP server for cloud and infrastructure.
- [shell-use](https://ai-powered.com/mcp/shell-use): shell-use is an open-source MCP server for developer tools.
- [Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway](https://ai-powered.com/mcp/starmux-all-in-one-self-hosted-remote-mcp-server-and-gateway): Starmux — All-in-One Self-Hosted Remote MCP Server & Gateway is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ssh-fleet-mcp-server
