Ssh Fleet MCP Server
MCP server that runs commands and tmux sessions on a fleet of SSH hosts
- 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-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"ssh-fleet-mcp-server": {
"command": "npx",
"args": [
"-y",
"ssh-fleet-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ssh-fleet-mcp-server": {
"command": "npx",
"args": [
"-y",
"ssh-fleet-mcp-server"
]
}
}
}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.