# SSH Session MCP

> SSH Session MCP is an open-source MCP server. Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Website:** https://zw-awa.github.io/ssh-session-mcp/
- **Repository:** https://github.com/zw-awa/ssh-session-mcp
- **MCP Registry name:** io.github.Zw-awa/ssh-session-mcp
- **Listing updated:** 2026-11-13

## About

Shared SSH PTY runtime for MCP clients with viewer, input lock, async tracking, and policy rules.

## Install

### Claude Code (Terminal)

```sh
claude mcp add ssh-session-mcp --env SSH_PASSWORD='<SSH_PASSWORD>' -- npx -y ssh-session-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "env": {
        "SSH_PASSWORD": "<SSH_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "env": {
        "SSH_PASSWORD": "<SSH_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ssh-session-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "env": {
        "SSH_PASSWORD": "<SSH_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "env": {
        "SSH_PASSWORD": "<SSH_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ssh-session-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "env": {
        "SSH_PASSWORD": "<SSH_PASSWORD>"
      }
    }
  }
}
```

## FAQ

### Is SSH Session MCP free?

Yes. SSH Session MCP is open source, so you can use and self-host it for free.

### How do I add SSH Session MCP to Claude Code?

Run this command in your terminal: claude mcp add ssh-session-mcp --env SSH_PASSWORD='<SSH_PASSWORD>' -- npx -y ssh-session-mcp

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/ssh-session-mcp
