Back to Browse

Ssh Session MCP Server

by Zw Awa
Developer ToolsUse Caution4.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.2
Use Caution4.2High Risk

ssh-session-mcp is a well-structured SSH PTY session manager with appropriate authentication handling and reasonable permissions for its purpose. Security is generally strong with input validation, policy-based command filtering, and user-aware access controls. However, some code quality concerns around error handling, broad exception catches, and potential sensitive data exposure in logs warrant attention. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

3 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

network_websocket

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

process_spawn

Check that this permission is expected for this type of plugin.

system_info

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Optional explicit path to ssh-session-mcp.config.json when the config is not in the current working directory.Optional

Environment variable: SSH_MCP_CONFIG

Optional runtime instance id used to isolate state across multiple MCP clients or agents.Optional

Environment variable: SSH_MCP_INSTANCE

Viewer HTTP port. Use auto to allocate a free local port, or 0 to disable the browser viewer.Optional

Environment variable: VIEWER_PORT

Optional viewer bind host. Defaults to 127.0.0.1 for local-only browser access.Optional

Environment variable: VIEWER_HOST

Set to true or 1 to automatically open the browser terminal when a session is created.Optional

Environment variable: AUTO_OPEN_TERMINAL

Operation mode. safe blocks risky or unsuitable terminal actions by default, while full allows broader execution.Optional

Environment variable: SSH_MCP_MODE

Set to true or 1 to run a local shell instead of opening a real SSH connection. Useful for demos and offline testing.Optional

Environment variable: SSH_MCP_LOCAL

Set to true or 1 to expose browser-side debug controls intended for demos and local troubleshooting.Optional

Environment variable: SSH_MCP_DEBUG

Legacy single-target SSH host when not using ssh-session-mcp.config.json device profiles.Optional

Environment variable: SSH_HOST

Legacy single-target SSH port when not using ssh-session-mcp.config.json device profiles.Optional

Environment variable: SSH_PORT

Legacy single-target SSH username when not using ssh-session-mcp.config.json device profiles.Optional

Environment variable: SSH_USER

Optional legacy password-based SSH authentication value.Required

Environment variable: SSH_PASSWORD

Optional path to a local SSH private key file for legacy single-target mode.Optional

Environment variable: SSH_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-zw-awa-ssh-session-mcp": {
      "env": {
        "SSH_KEY": "your-ssh-key-here",
        "SSH_HOST": "your-ssh-host-here",
        "SSH_PORT": "your-ssh-port-here",
        "SSH_USER": "your-ssh-user-here",
        "VIEWER_HOST": "your-viewer-host-here",
        "VIEWER_PORT": "your-viewer-port-here",
        "SSH_MCP_MODE": "your-ssh-mcp-mode-here",
        "SSH_PASSWORD": "your-ssh-password-here",
        "SSH_MCP_DEBUG": "your-ssh-mcp-debug-here",
        "SSH_MCP_LOCAL": "your-ssh-mcp-local-here",
        "SSH_MCP_CONFIG": "your-ssh-mcp-config-here",
        "SSH_MCP_INSTANCE": "your-ssh-mcp-instance-here",
        "AUTO_OPEN_TERMINAL": "your-auto-open-terminal-here"
      },
      "args": [
        "-y",
        "ssh-session-mcp"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!

Ssh Session MCP Server - Shared SSH PTY runtime for MCP clients with viewer, input | MCP Marketplace