MCP SSH Session

An MCP (Model Context Protocol) server that enables AI agents to establish and manage persistent SSH sessions.

Features

Persistent Sessions: SSH connections are reused across multiple command executions
SSH Config Support: Automatically reads and uses settings from ~/.ssh/config
Multi-host Support: Manage connections to multiple hosts simultaneously
Automatic Reconnection: Dead connections are detected and automatically re-established
Thread-safe: Safe for concurrent operations

Installation

Using Claude Code

Add to your ~/.claude.json:

{ "mcpServers": { "mcp-ssh-session": { "type": "stdio", "command": "uvx", "args": ["--from", "/path/to/mcp-ssh-session", "mcp-ssh-session"], "env": {} } } }

Replace /path/to/mcp-ssh-session with the actual path to this project.

Using MCP Inspector

npx @modelcontextprotocol/inspector uvx --from /path/to/mcp-ssh-session mcp-ssh-session

Development Installation

uv venv source .venv/bin/activate uv pip install -e .

Usage

Available Tools

`execute_command`

Execute a command on an SSH host using a persistent session.

Using SSH config alias:

{ "host": "myserver", "command": "uptime" }

Using explicit parameters:

{ "host": "example.com", "username": "user", "command": "ls -la", "key_filename": "~/.ssh/id_rsa", "port": 22 }

`list_sessions`

List all active SSH sessions.

`close_session`

Close a specific SSH session.

{ "host": "myserver" }

`close_all_sessions`

Close all active SSH sessions.

SSH Config Support

The server automatically reads ~/.ssh/config and supports:

Host aliases
Hostname mappings
Port configurations
User specifications
IdentityFile settings

Example ~/.ssh/config:

Host myserver HostName example.com User myuser Port 2222 IdentityFile ~/.ssh/id_rsa

Then simply use:

{ "host": "myserver", "command": "uptime" }

Documentation

See CLAUDE.md for detailed documentation.

License

[Add license information]

Deploy Server

HTTP connection URL

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Enables AI agents to establish and manage persistent SSH connections to remote hosts for executing commands. Supports SSH config files, multi-host management, and automatic reconnection with thread-safe concurrent operations.

MCP SSH Session

MCP SSH Session

Features

Installation

Using Claude Code

Using MCP Inspector

Development Installation

Usage

Available Tools

`execute_command`

`list_sessions`

`close_session`

`close_all_sessions`

SSH Config Support

Documentation

License

Tools

New MCP Servers

MCP directory API