SSH Session MCP

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

Connector by Zw-awa · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)★ 4

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/zw-awa-ssh-session-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 10 read · 7 write · 3 delete · 3 not yet classified
Secrets: 2 (API keys, tokens or passwords)
Install scripts: Not scanned yet
Runs as: Node.js package

Tools by what they do 23

Read from the source code; the running server may list different tools.

Read 10 · Look things up without changing anything.

ssh-command-status
ssh-device-list
ssh-session-diagnostics
ssh-session-history
ssh-session-list
ssh-session-policy-list
ssh-session-read
ssh-session-watch
ssh-status
ssh-viewer-list

Write 7 · Create, change, send or run things.

ssh-retry
ssh-run
ssh-session-control
ssh-session-policy-upsert
ssh-session-resize
ssh-session-send
ssh-session-set-active

Delete 3 · Delete, drop, revoke or wipe things.

ssh-session-close
ssh-session-policy-remove
ssh-session-policy-reset

Not yet classified 3 · We could not tell from the name and description.

ssh-quick-connect
ssh-session-open
ssh-viewer-ensure

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

SSH_KEY
SSH_PASSWORD

Other settings (environment variables or headers).

AUTO_OPEN_TERMINAL
SSH_HOST
SSH_MCP_CONFIG
SSH_MCP_DEBUG
SSH_MCP_INSTANCE
SSH_MCP_LOCAL
SSH_MCP_MODE
SSH_PORT
SSH_USER
VIEWER_HOST
VIEWER_PORT

Tools (23)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

ssh-command-status
Check the status of a long-running async command. Returns current output if completed, or partial output if still running.
ssh-device-list
List configured SSH device profiles discovered from ssh-session-mcp.config.json.
ssh-quick-connect
One-step: open SSH session using configured device profiles when available, otherwise fall back to legacy .env defaults. Reuse an existing session when possible and return viewer details when enabled.
ssh-retry
Execute a command with automatic retry and backoff on failure. Useful for flaky network commands or services that need time to start.
ssh-run
Execute a command in the SSH session and return the output. Uses intelligent completion detection (prompt matching + idle timeout). In safe mode, dangerous/interactive commands are blocked. Long-running commands automatically transition to async mode.
ssh-session-close
Close an interactive SSH PTY session immediately and remove it from the MCP server.
ssh-session-control
Send a control key to an interactive SSH PTY session. Actor is shown inline in the dashboard transcript.
ssh-session-diagnostics
Inspect session health, buffer trim state, viewer attachment state, input lock state, and tracked command metadata.
ssh-session-history
Read line-numbered session history built from terminal output and user/agent actions.
ssh-session-list
List tracked SSH PTY sessions. Closed sessions are kept briefly for inspection, then automatically pruned.
ssh-session-open
Open a persistent interactive SSH PTY session with automatic idle cleanup and a terminal-style dashboard view.
ssh-session-policy-list
List the inherited and session-level custom policy rules currently active for an SSH session.
ssh-session-policy-remove
Remove a session-level custom policy rule by id.
ssh-session-policy-reset
Reset the current session custom policy rules back to the inherited defaults loaded from configuration.
ssh-session-policy-upsert
Add or update a session-level custom policy rule. Session rules are applied after immutable built-in hard blocks and before the built-in safe/full warning set.

Show 8 more tools

ssh-session-read
Read raw buffered terminal output from an SSH PTY session. Supports optional long-polling for new terminal output.
ssh-session-resize
Resize the PTY window of an interactive SSH session.
ssh-session-send
Send raw input to an interactive SSH PTY session. Actor is shown inline in the dashboard transcript.
ssh-session-set-active
Set or clear the active session used by tools when the session argument is omitted.
ssh-session-watch
Long-poll an SSH PTY session and render a terminal-style dashboard with inline actor markers.
ssh-status
Quick status check: list active sessions, viewer URL, connection state. Use this to check if a session is already running.
ssh-viewer-ensure
Ensure that a viewer exists for a session. Terminal mode is singleton-scoped and will reuse a running viewer instead of opening duplicates.
ssh-viewer-list
List persisted local viewer processes and their current binding state.

Signals

Stars: 4
Forks: 1
Open issues: 1
Last commit: Jun 25, 2026 (4 months ago)
Last release: May 27, 2026 (5 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.Zw-awa/ssh-session-mcp
Version: 2.7.1
Auth: API key
Packages: npm ssh-session-mcp
License: Apache-2.0
Repository: github.com/Zw-awa/ssh-session-mcp
Website: zw-awa.github.io/ssh-session-mcp/
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

Cite this page

SSH Session MCP. Agent Mart. https://agentmart.dev/connectors/zw-awa-ssh-session-mcp (last updated 2026-10-24)