NestDaddy

MCP SSH Gateway

io.github.d00mus/mcp-ssh-gateway ยท v7.0.0

SSH terminals for AI agents: stateful shells, exit codes the moment a command ends, router CLIs.

Connect Runs on your machine

Terminal
claude mcp add mcp-ssh-gateway -e SSH_SERVERS_CONFIG=<SSH_SERVERS_CONFIG> -e SSH_MCP_CACHE_DIR=<SSH_MCP_CACHE_DIR> -e SSH_READ_ONLY=<SSH_READ_ONLY> -e SSH_COMMAND_BLACKLIST=<SSH_COMMAND_BLACKLIST> -- uvx mcp-ssh-gateway==7.0.0
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-ssh-gateway": {
      "command": "uvx",
      "args": [
        "mcp-ssh-gateway==7.0.0"
      ],
      "env": {
        "SSH_SERVERS_CONFIG": "<SSH_SERVERS_CONFIG>",
        "SSH_MCP_CACHE_DIR": "<SSH_MCP_CACHE_DIR>",
        "SSH_READ_ONLY": "<SSH_READ_ONLY>",
        "SSH_COMMAND_BLACKLIST": "<SSH_COMMAND_BLACKLIST>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "mcp-ssh-gateway": {
      "command": "uvx",
      "args": [
        "mcp-ssh-gateway==7.0.0"
      ],
      "env": {
        "SSH_SERVERS_CONFIG": "<SSH_SERVERS_CONFIG>",
        "SSH_MCP_CACHE_DIR": "<SSH_MCP_CACHE_DIR>",
        "SSH_READ_ONLY": "<SSH_READ_ONLY>",
        "SSH_COMMAND_BLACKLIST": "<SSH_COMMAND_BLACKLIST>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp-ssh-gateway": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-ssh-gateway==7.0.0"
      ],
      "env": {
        "SSH_SERVERS_CONFIG": "<SSH_SERVERS_CONFIG>",
        "SSH_MCP_CACHE_DIR": "<SSH_MCP_CACHE_DIR>",
        "SSH_READ_ONLY": "<SSH_READ_ONLY>",
        "SSH_COMMAND_BLACKLIST": "<SSH_COMMAND_BLACKLIST>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
SSH_SERVERS_CONFIG
Optional
Path to the JSON file with SSH server targets, or an inline JSON string. Overridden by --servers-config.
SSH_MCP_CACHE_DIR
Optional
Where logs and known_hosts are kept. Default: the user cache directory.
SSH_READ_ONLY
Optional
Set to true/1 to force the global read-only guardrail.
SSH_COMMAND_BLACKLIST
Optional
Comma-separated global prohibited command patterns.

Details

Package[email protected] (PYPI, stdio)
First published29 Sep 2026
Last updated29 Sep 2026
Registry nameio.github.d00mus/mcp-ssh-gateway

More ai and media servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.