mcp server

simple-mcp-ssh

A simple MCP server to provide way for actions for remote macine Agent.

Rudnik-Ilia/simple-mcp-sshcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "simple-mcp-ssh": {
      "command": "uvx",
      "args": [
        "mcp-ssh"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 23, 2026

MCP SSH Server

MCP server providing SSH remote access tools via FastMCP.

Features

SSH session management (connect/disconnect)
Command execution (standard and PTY mode)
Interactive shell sessions
Remote file read/write via SFTP

Installation

uv sync

Configuration

Create .env file:

SSH_HOST=your-host
SSH_USERNAME=your-user
SSH_PASSWORD=your-password
SSH_PORT=22

Usage

As MCP Server (Cursor/Claude)

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "ssh": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/project", "python", "-m", "mcp_ssh"]
    }
  }
}

Debug with Inspector

npx @modelcontextprotocol/inspector@0.6.0 uv run python -m mcp_ssh

Tools

Tool	Description
`ssh_connect`	Open SSH session using configured credentials
`ssh_disconnect`	Close SSH session
`ssh_run`	Execute command on remote host
`ssh_run_pty`	Execute command with PTY (for interactive programs)
`ssh_read_file`	Read remote file content
`ssh_write_file`	Write content to remote file
`ssh_shell_open`	Open interactive shell session
`ssh_shell_send`	Send input to interactive shell
`ssh_shell_close`	Close interactive shell
`ssh_active_sessions`	List active SSH sessions
`ssh_active_shells`	List active shell sessions

Development

uv sync --all-extras
uv run ruff check src
uv run mypy src
uv run pytest

License

MIT