# fast-mcp-ssh

Gives AI agents SSH access to configured hosts for command execution, file operations, and remote desktop captures. Connects over MCP stdio.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 5
- Author: klNuno
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/klNuno/fast-mcp-ssh
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/fast-mcp-ssh

## What it does

The server runs one-off commands and persistent PTY sessions that retain the current directory and environment variables. SFTP handles file transfers, including copies between configured hosts. Tools also capture remote desktops and create local TCP forwards.

Access rules can block operations or ask the user to confirm them; `read_only` prevents actions that look like writes. Calls are recorded in `~/.fast-mcp-ssh/audit.log`, with credentials scrubbed. These checks help prevent accidents, but they do not defend against a model controlled by an attacker.

Install from source with `cargo install fast-mcp-ssh`. Host settings live in `~/.fast-mcp-ssh/hosts.toml`, and the MCP configuration starts `fast-mcp-ssh` over stdio. Remote screenshots depend on one of the supported capture utilities being available on the host.

## Requirements
- Needs: a prebuilt binary from the repository releases

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- run a command on a remote host
- keep shell state between commands in a PTY session
- copy a file between configured hosts
- capture a remote desktop image
- restrict SSH actions with access rules

## Example prompts
- Connect to a configured host and run `uname -a`.
- Open a PTY session on the host, change directories, and show the current path.
- Copy a file from one configured host to another using SFTP.

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23654
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12110

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md