Skip to content
MCP server

Ssh Fleet MCP Server

MCP server that runs commands and tmux sessions on a fleet of SSH hosts

Runs locally
Install
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.2.2
Listing updated
3 days ago

Similar MCP servers

About Ssh Fleet MCP Server

Ssh Fleet MCP Server is an MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ssh-fleet-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-fleet-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ssh-fleet-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-fleet-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Ssh Fleet MCP Server 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.

How AIPoweredBot checks servers