Skip to main content
Glama
ssh-mcp-pro

ssh-mcp-pro

by oaslananka

ssh-mcp-pro is a secure Model Context Protocol (MCP) server for SSH automation. It lets MCP-capable clients open SSH sessions, inspect hosts, run guarded commands, manage files, transfer artifacts, create tunnels, and perform idempotent package or service work through policy-controlled tools.

Prerequisites

  • Node.js >=22.22.2 or >=24.15.0 or >=26.3.0

  • pnpm ^11.28.11 (use Corepack for development)

  • SSH access to the target hosts

  • Docker, only for local integration tests and container image builds

Related MCP server: mcpx

Installation

For Windows/Linux outbound agent connection status, rotating diagnostics and a live PowerShell log view, see Agent Activity Monitor.

Install globally with pnpm:

pnpm add --global ssh-mcp-pro
ssh-mcp-pro --version

Run without a global install:

npx ssh-mcp-pro

For pnpm-only environments, use:

pnpm dlx ssh-mcp-pro

Container images are published to GitHub Container Registry for release tags:

docker run --rm ghcr.io/oaslananka/ssh-mcp-pro:1.4.1 --version

Images are published for linux/amd64 and linux/arm64 with exact semver and Git tag aliases. Production deployments should prefer the digest-pinned reference recorded by the release workflow. See Docker Usage for the tag policy, digest-pinned examples, and registry verification steps.

Cloud dashboard and AI connectors

The optional ssh-mcp-pro Cloud lets you sign in with Google or GitHub, enroll your own devices, and connect an OAuth-capable AI client to https://ssh-mcp-pro.oaslananka.dev/mcp. Your SSH private keys remain on your devices.

After installing the package, start a local web dashboard with one command:

ssh-mcp-pro web

The shortcut binds only to http://127.0.0.1:3000/dashboard and does not publish a privileged server to your network. Signing in requires your own configured GitHub or Google OAuth application. For hosted, multi-user operation use the production control plane configuration; the localhost command is for local development and testing.

The hosted service serves Privacy and Terms. Operators may enable an owner-only Usage & Users tab by setting SSH_MCP_DASHBOARD_OWNER_GITHUB_LOGINS and/or SSH_MCP_DASHBOARD_OWNER_GOOGLE_EMAILS; global usage access is disabled by default. The separately gated OpenAI reviewer sandbox uses a dedicated sample-only identity and is not a general sign-in method.

See Web publication readiness for ChatGPT, Claude, and Gemini connection steps and independent acceptance requirements. Manifest validation alone does not mean any platform has approved the plugin.

Quickstart

Generic stdio MCP config:

{
  "name": "ssh-mcp-pro",
  "command": "ssh-mcp-pro",
  "type": "stdio"
}

VS Code workspace .vscode/mcp.json configuration:

{
  "servers": {
    "ssh-mcp-pro": {
      "type": "stdio",
      "command": "ssh-mcp-pro",
      "args": []
    }
  }
}

Claude Desktop style:

{
  "mcpServers": {
    "ssh-mcp-pro": {
      "command": "ssh-mcp-pro",
      "args": []
    }
  }
}

After registration, start with discovery and a strict host-key policy:

List configured SSH hosts, open a session to bastion.example.com as deploy with hostKeyPolicy=strict, then run os_detect.

Usage

Use ssh-mcp-pro from an MCP client over stdio, or run the HTTP transport for remote-safe connector profiles. Start with read-only discovery tools, inspect the active policy, and create explicit sessions before running remote commands:

List configured SSH hosts, explain the active SSH policy, connect to the selected host, then report its operating system and disk usage.

See examples/README.md for additional workflows and INSTALL.md for client-specific setup.

General computer control through the hosted connector

Once a user has enrolled a computer, ChatGPT, Claude or another authorized MCP client can manage it using generic tools, regardless of whether the computer has Git, Docker, a database, or other applications installed:

  • Run an installed application: run_shell or the managed process_start, process_read, process_input and process_stop tools. The shell is the native PowerShell on Windows or sh on Unix.

  • Find and inspect files: file_search, file_content_search, file_inspect (stat / list) and file_read.

  • Manage project files: file_manage (mkdir, copy, move, remove), file_write, and the preview/expected-hash file_replace. Directory listings and file searches are bounded. File management operates on the selected device itself rather than transferring entire files through the AI conversation.

Choose Full Admin for a device when you want unrestricted access within that operating-system user account. New Full Admin profiles can work with ordinary home, project and mounted-disk paths; the OS account still determines whether an operation succeeds. The device owner's saved custom allow/deny rules still take priority. Existing enrolled devices retain their saved policies until the owner edits them in the dashboard. OAuth scopes separately control which of those device operations a connected AI client may request.

Dedicated Docker MCP tools are no longer advertised to newly connecting clients. Previously authorized clients may still use the legacy Docker tool names during the compatibility period; new users can call an installed application's own CLI through the generic shell instead. This does not provide GUI screen, mouse, keyboard or browser interaction: those require desktop-session integration and OS accessibility/screen permissions.

Configuration

All SSH_MCP_* environment variables parsed by src/config.ts are listed below. Comma-separated settings also accept newline-separated values.

Variable

Default

Purpose

SSH_MCP_MAX_SESSIONS

20

Maximum concurrent SSH sessions.

SSH_MCP_SESSION_TTL

900000

Session time-to-live in milliseconds.

SSH_MCP_COMMAND_TIMEOUT

30000

Default remote command timeout in milliseconds.

SSH_MCP_MAX_COMMAND_OUTPUT_BYTES

1048576

Maximum buffered stdout/stderr bytes per command result.

SSH_MCP_MAX_STREAM_CHUNKS

4096

Maximum retained streaming chunks.

SSH_MCP_MAX_FILE_SIZE

10485760

Maximum bytes returned by text-focused file reads.

SSH_MCP_MAX_FILE_WRITE_BYTES

10485760

Maximum accepted write payload before buffering.

SSH_MCP_MAX_TRANSFER_BYTES

52428800

Maximum upload or download transfer size.

SSH_MCP_DEBUG

false

Enables debug-oriented configuration behavior.

SSH_MCP_RATE_LIMIT

true

Enables the global MCP request rate limiter.

SSH_MCP_RATE_LIMIT_MAX

100

Maximum requests per rate-limit window.

SSH_MCP_RATE_LIMIT_PER_SESSION

true

Enables per-session MCP request rate limiting when tool arguments include sessionId.

SSH_MCP_RATE_LIMIT_PER_SESSION_MAX

50

Maximum requests per SSH session per rate-limit window.

SSH_MCP_RATE_LIMIT_PER_SESSION_WINDOW_MS

60000

Per-session rate-limit window in milliseconds.

SSH_MCP_RATE_LIMIT_WINDOW_MS

60000

Rate-limit window in milliseconds.

SSH_MCP_STRICT_HOST_KEY

unset

Legacy boolean alias for strict vs insecure host-key checking.

SSH_MCP_HOST_KEY_POLICY

strict

Host-key mode: strict, accept-new, or insecure.

SSH_MCP_KNOWN_HOSTS_PATH

~/.ssh/known_hosts

Known hosts file used for strict host-key verification.

SSH_MCP_ALLOW_ROOT_LOGIN

false

Allows SSH login as root and mirrors into policy.

SSH_MCP_ALLOWED_CIPHERS

empty

Optional SSH cipher allowlist.

SSH_MCP_POLICY_FILE

unset

JSON file containing partial policy overrides.

SSH_MCP_POLICY_MODE

enforce

Policy decision mode: enforce or explain.

SSH_MCP_ALLOW_RAW_SUDO

false

Allows raw proc_sudo; prefer ensure_* tools.

SSH_MCP_ALLOW_DESTRUCTIVE_COMMANDS

false

Allows commands matching destructive command policy.

SSH_MCP_ALLOW_DESTRUCTIVE_FS

false

Allows destructive filesystem operations such as fs_rmrf.

SSH_MCP_ALLOWED_HOSTS

empty

Host allowlist for policy and remote connector safety checks.

SSH_MCP_COMMAND_ALLOW

empty

Command allow patterns.

SSH_MCP_COMMAND_DENY

empty

Command deny patterns.

SSH_MCP_PATH_ALLOW_PREFIXES

/tmp,/var/tmp,/home,/Users

Remote path prefixes allowed by filesystem policy.

SSH_MCP_PATH_DENY_PREFIXES

/etc/sudoers,/etc/shadow,/etc/passwd,/boot,/dev,/proc

Remote path prefixes denied by filesystem policy.

SSH_MCP_LOCAL_PATH_ALLOW_PREFIXES

OS temp directory

Local paths allowed for transfer operations.

SSH_MCP_LOCAL_PATH_DENY_PREFIXES

empty

Local paths denied for transfer operations.

SSH_MCP_TUNNEL_ALLOW_BIND_HOSTS

127.0.0.1,localhost,::1

Local bind hosts allowed for tunnels.

SSH_MCP_TUNNEL_DENY_BIND_HOSTS

0.0.0.0,::

Local bind hosts denied for tunnels.

SSH_MCP_TUNNEL_ALLOW_REMOTE_HOSTS

empty

Optional remote tunnel target host allowlist.

SSH_MCP_TUNNEL_DENY_REMOTE_HOSTS

empty

Optional remote tunnel target host denylist.

SSH_MCP_TUNNEL_ALLOW_PORTS

empty

Optional tunnel port allowlist.

SSH_MCP_TUNNEL_DENY_PORTS

empty

Optional tunnel port denylist.

SSH_MCP_HTTP_HOST

127.0.0.1

Streamable HTTP bind host.

SSH_MCP_HTTP_PORT

3000

Streamable HTTP bind port.

SSH_MCP_HTTP_ALLOWED_ORIGINS

http://127.0.0.1,http://localhost

Browser origins allowed for HTTP clients.

SSH_MCP_HTTP_BEARER_TOKEN_FILE

unset

Bearer token file for HTTP transport. Required for non-loopback bearer deployments.

SSH_MCP_ENABLE_LEGACY_SSE

false

Enables legacy SSE compatibility.

SSH_MCP_HTTP_MAX_REQUEST_BODY_BYTES

1048576

Maximum HTTP request body size.

SSH_MCP_HTTP_MAX_SESSIONS

20

Maximum active Streamable HTTP MCP sessions. Expired sessions are cleaned first; if capacity is still full, the oldest idle session is evicted so abandoned clients do not cause persistent 502s. Use 100 for ChatGPT/Cloudflare production deployments.

SSH_MCP_HTTP_SESSION_IDLE_TTL_MS

900000

HTTP MCP session idle timeout in milliseconds. Use 300000 for ChatGPT/Cloudflare production deployments where clients may abandon sessions without DELETE.

SSH_MCP_HTTP_PUBLIC_URL

unset

Stable public HTTPS MCP URL for protected resource metadata.

SSH_MCP_HTTP_TRUST_PROXY

false

Trust reverse proxy forwarded headers.

SSH_MCP_TOOL_PROFILE

full

Active tool exposure profile.

SSH_MCP_CONNECTOR_PROFILE

full

Alias for SSH_MCP_TOOL_PROFILE.

SSH_MCP_CONNECTOR_CREDENTIAL_PROVIDER

none

Credential provider: none, agent, or command.

SSH_MCP_CONNECTOR_CREDENTIAL_COMMAND

unset

External credential command when provider is command.

SSH_MCP_CONNECTOR_CREDENTIAL_COMMAND_ARGS

empty

Arguments passed to the external credential command.

SSH_MCP_CONNECTOR_CREDENTIAL_COMMAND_TIMEOUT_MS

5000

Credential command timeout in milliseconds.

SSH_MCP_CONNECTOR_DEFAULT_USERNAME

unset

Default username for connector broker flows.

SSH_MCP_HTTP_AUTH_MODE

bearer

HTTP auth mode: bearer or oauth.

SSH_MCP_OAUTH_ISSUER

unset

Expected OAuth issuer.

SSH_MCP_OAUTH_AUDIENCE

unset

Expected OAuth audience.

SSH_MCP_OAUTH_JWKS_URL

unset

OAuth JWKS URL.

SSH_MCP_OAUTH_RESOURCE

unset

OAuth protected resource identifier.

SSH_MCP_OAUTH_REQUIRED_SCOPES

ssh-mcp-pro.read

Required OAuth scopes.

SSH_MCP_OAUTH_ALLOWED_ALGORITHMS

unset

Optional comma-separated JWT algorithm allowlist, for example RS256,ES256. When unset, the built-in OAuth verifier defaults are used.

SSH_MCP_REVIEWER_USERNAME

unset

Optional dedicated OpenAI reviewer username. Reviewer access remains disabled unless the matching scrypt hash is also configured.

SSH_MCP_REVIEWER_PASSWORD_HASH

unset

Optional scrypt hash for the dedicated OpenAI reviewer account; never store the plaintext password here. See OpenAI Reviewer Sandbox.

SSH_MCP_REMOTE_AGENT_MCP_PASSTHROUGH

unset

When enabled with 1, true, yes, or on, lets /mcp requests bypass the remote control plane and reach the Streamable HTTP MCP handler. Use only for connector routing migrations.

The parser also accepts non-SSH_MCP_* compatibility aliases PORT, KNOWN_HOSTS_PATH, and STRICT_HOST_KEY_CHECKING.

Tool Profiles

full exposes every registered tool, resource, and prompt. Every other profile uses an explicit per-profile allowset. chatgpt and claude currently expose the same baseline connector tools as remote-safe, with empty client-specific extension sets reserved for future additions.

Profile

Exposed tools

Exposed resources

Exposed prompts

full

All SSH, process, filesystem, transfer, ensure, tunnel, connector, and system tools.

All runtime resources.

All prompts.

remote-safe

connector_status, ssh_hosts_list, ssh_policy_explain, ssh_host_inspect, ssh_mutation_plan.

ssh-mcp-pro://capabilities/support-matrix.

inspect-host-capabilities, plan-mutation.

chatgpt

Baseline remote connector tools plus an empty ChatGPT extension set.

Same remote connector subset as remote-safe.

Same remote connector subset as remote-safe.

claude

Baseline remote connector tools plus an empty Claude extension set.

Same remote connector subset as remote-safe.

Same remote connector subset as remote-safe.

remote-readonly

Same remote connector subset as remote-safe.

Same remote connector subset as remote-safe.

Same remote connector subset as remote-safe.

remote-broker

Same remote connector subset as remote-safe.

Same remote connector subset as remote-safe.

Same remote connector subset as remote-safe.

SSH_MCP_CHATGPT_EXTRA_TOOLS and SSH_MCP_CLAUDE_EXTRA_TOOLS can extend their profiles for loopback-only development. Non-loopback HTTP startup validates the fully resolved tool set against the canonical remote-safe allowlist and refuses unknown, session, transfer, filesystem mutation, process, sudo, service mutation, or tunnel tools. The startup error lists only the rejected tool names. Adding an extension locally does not make that tool approved for public connector exposure.

Security Defaults

ssh-mcp-pro starts with strict SSH host-key verification, denies root login, denies raw sudo, blocks destructive commands and filesystem operations unless policy allows them, and refuses non-loopback HTTP startup unless authentication, origins, public HTTPS URL, strict host-key verification, a remote-safe tool profile, and host allowlists are configured. See SECURITY.md for vulnerability reporting and SECURITY_DECISIONS.md for the design rationale behind these defaults.

More Documentation

Project Health & Governance

Contributing

See CONTRIBUTING.md for setup, quality gates, commit rules, and pull request expectations. Participation is governed by the Code of Conduct.

License

ssh-mcp-pro project-authored source is available under GNU AGPL v3.0.

Agent plugin and runtime configuration

This repository owns the product-level agent plugin, MCP runtime configuration, and product-specific skills for ssh-mcp-pro. The central agent-tools repository should catalog this plugin, but the manifest and workflow instructions live here so they stay synchronized with the actual MCP server package.

File

Purpose

.claude-plugin/plugin.json

Claude Code-valid product plugin manifest.

.mcp.json

Claude Code project-local MCP server configuration.

.codex/config.example.toml

Codex CLI MCP configuration example.

.vscode/mcp.example.json

VS Code / GitHub Copilot workspace MCP configuration example.

opencode.example.jsonc

OpenCode project MCP configuration example.

.opencode/skills/

OpenCode-native mirrored skill definitions.

docs/agent-runtime-config.md

Agent runtime setup and validation notes.

Validate plugin packaging locally:

claude plugin validate .

Available Tools

46 tools
connector_statusConnector StatusA
Read-onlyIdempotent

Use this when ChatGPT or Claude needs to understand the remote connector profile, authentication mode, and credential broker readiness without exposing secrets.

Inputs: no named parameters. Returns: Remote connector readiness without secrets

cpu_usageCPU UsageA
Read-onlyIdempotent

Reports CPU load average and uptime on the remote system

Inputs: sessionId (required). Returns: Remote command result

disk_usageDisk UsageA
Read-onlyIdempotent

Reports disk usage for filesystems on the remote system

Inputs: sessionId (required), path. Returns: Remote command result

ensure_lines_in_fileEnsure Lines In FileA
DestructiveIdempotent

Ensures specific lines are present or absent in a file

Inputs: path (required), lines (required), sessionId (required), state, +1 more. Returns: Line management result

ensure_packageEnsure Package StateB
DestructiveIdempotent

Ensures a package is installed or removed

Inputs: name (required), sessionId (required), state. Returns: Package state result

ensure_serviceEnsure Service StateA
DestructiveIdempotent

Ensures a service is in the desired state

Inputs: name (required), state (required), sessionId (required). Returns: Service state result

file_downloadDownload FileA
Read-only

Downloads a remote file to the local machine over SFTP

Inputs: localPath (required), sessionId (required), remotePath (required). Returns: File transfer result with integrity details

file_uploadUpload FileA
Destructive

Uploads a local file to the remote host over SFTP

Inputs: localPath (required), sessionId (required), remotePath (required). Returns: File transfer result with integrity details

fs_listList Remote DirectoryA
Read-onlyIdempotent

Lists directory contents

Inputs: path (required), sessionId (required), page, limit. Returns: Remote directory entries

fs_mkdirpCreate Remote DirectoriesA
Idempotent

Creates directories recursively

Inputs: path (required), sessionId (required). Returns: Remote file operation result

fs_readRead Remote FileB
Read-onlyIdempotent

Reads a file from the remote system

Inputs: path (required), sessionId (required), encoding, maxBytes. Returns: Remote file content

fs_renameRename Remote PathB
Destructive

Renames or moves a file/directory

Inputs: to (required), from (required), sessionId (required). Returns: Remote file operation result

fs_rmrfRemove Remote Path RecursivelyA
Destructive

Removes files or directories recursively

Inputs: path (required), sessionId (required). Returns: Remote file operation result

fs_statStat Remote PathB
Read-onlyIdempotent

Gets file or directory statistics

Inputs: path (required), sessionId (required). Returns: Remote path stat result

fs_writeWrite Remote FileA
Destructive

Writes data to a file on the remote system

Inputs: data (required), path (required), sessionId (required), mode. Returns: Remote file operation result

get_metricsGet Runtime MetricsA
Read-onlyIdempotent

Returns server metrics including session counts, command statistics, and uptime

Inputs: format. Returns: Runtime metrics

log_tailTail LogA
Read-onlyIdempotent

Tails the end of a log file or reads recent journal entries for a service

Inputs: sessionId (required), path, lines, service. Returns: Remote command result

memory_infoMemory InfoA
Read-onlyIdempotent

Reports memory usage on the remote system

Inputs: sessionId (required). Returns: Remote command result

net_interfacesNetwork InterfacesA
Read-onlyIdempotent

Lists network interfaces and their IP addresses on the remote system

Inputs: sessionId (required). Returns: Remote command result

os_detectDetect Remote OSA
Read-onlyIdempotent

Detects operating system and environment information

Inputs: sessionId (required). Returns: Remote operating system information

patch_applyApply PatchB
Destructive

Applies a patch to a file

Inputs: diff (required), path (required), sessionId (required). Returns: Patch application result

port_checkPort CheckB
Read-onlyIdempotent

Checks which processes are listening on a specific port

Inputs: port (required), sessionId (required), host. Returns: Remote command result

proc_execExecute Remote CommandA

Executes a non-interactive command on the remote system after policy and safety checks

Inputs: command (required), sessionId (required), cwd, env, +1 more. Returns: Remote command result

proc_exec_streamExecute Streaming CommandB

Executes a command and returns streaming output chunks

Inputs: command (required), sessionId (required), cwd, env, +1 more. Returns: Streaming command result with output chunks

proc_killSignal ProcessB
Destructive

Sends a signal to a running process by PID

Inputs: pid (required), sessionId (required), signal. Returns: Remote command result

proc_listList ProcessesA
Read-onlyIdempotent

Lists running processes on the remote system sorted by CPU usage

Inputs: sessionId (required). Returns: Remote command result

proc_sudoExecute Sudo CommandA
Destructive

Executes a command with sudo privileges only when allowRawSudo policy permits it

Inputs: command (required), sessionId (required), cwd, timeoutMs. Returns: Remote command result

service_listList ServicesA
Read-onlyIdempotent

Lists all systemd services and their current state

Inputs: sessionId (required). Returns: Remote command result

service_logsService LogsA
Read-onlyIdempotent

Reads recent journal logs for a systemd service

Inputs: name (required), sessionId (required), lines. Returns: Remote command result

service_restartRestart ServiceB

Restarts a systemd service

Inputs: name (required), sessionId (required). Returns: Remote command result

service_statusService StatusB
Read-onlyIdempotent

Gets the status of a systemd service

Inputs: name (required), sessionId (required). Returns: Remote command result

service_stopStop ServiceA
Destructive

Stops a systemd service

Inputs: name (required), sessionId (required). Returns: Remote command result

ssh_close_sessionClose SSH SessionB
Idempotent

Closes an SSH session

Inputs: sessionId (required). Returns: Session close result

ssh_host_inspectInspect SSH HostA
Read-only

Use this when ChatGPT or Claude needs read-only host inspection through the server-side credential broker. The user supplies only a configured host alias and selected checks; no secret material or login details are accepted.

Inputs: hostAlias (required), checks. Returns: Read-only host inspection result

ssh_hosts_listList Safe SSH Host AliasesA
Read-onlyIdempotent

Use this when ChatGPT or Claude needs a safe list of SSH host aliases that may be inspected through the remote connector. Sensitive login material is omitted.

Inputs: no named parameters. Returns: Redacted SSH host aliases allowed by policy

ssh_list_configured_hostsList Configured HostsA
Read-onlyIdempotent

Lists all hosts configured in ~/.ssh/config

Inputs: no named parameters. Returns: Configured SSH host aliases

ssh_list_sessionsList SSH SessionsA
Read-onlyIdempotent

Lists all active SSH sessions with their details

Inputs: no named parameters. Returns: Active SSH sessions

ssh_mutation_planPlan SSH MutationA
Read-onlyIdempotent

Use this when ChatGPT or Claude needs a non-executing plan for a remote SSH change. It never runs commands, writes files, uploads data, starts tunnels, or escalates privileges.

Inputs: goal (required), hostAlias (required), category. Returns: Non-executing remote mutation plan

ssh_open_sessionOpen SSH SessionB

Opens a new SSH session with authentication

Inputs: host (required), username (required), auth, port, +12 more. Returns: Session creation result or explain-mode connection plan

ssh_pingPing SSH SessionA
Read-onlyIdempotent

Checks if an SSH session is still alive and responsive

Inputs: sessionId (required). Returns: Session health check result

ssh_policy_explainExplain SSH PolicyA
Read-onlyIdempotent

Use this when ChatGPT or Claude needs to explain whether a requested SSH inspection or mutation would be allowed. This is explain-only and does not execute commands or open tunnels.

Inputs: path, action, command, hostAlias. Returns: Explain-only policy decision

ssh_resolve_hostResolve SSH HostA
Read-onlyIdempotent

Resolves a host alias from ~/.ssh/config to connection parameters

Inputs: hostAlias (required). Returns: Resolved SSH connection parameters

tunnel_closeClose SSH TunnelB
Idempotent

Closes an active tunnel

Inputs: tunnelId (required). Returns: Tunnel close result

tunnel_listList SSH TunnelsA
Read-onlyIdempotent

Lists active tunnels, optionally filtered by session

Inputs: sessionId. Returns: Active SSH tunnels

tunnel_local_forwardCreate Local SSH TunnelC

Creates a local SSH port forward

Inputs: localPort (required), sessionId (required), remoteHost (required), remotePort (required). Returns: SSH tunnel info

tunnel_remote_forwardCreate Remote SSH TunnelB

Creates a remote SSH port forward

Inputs: localHost (required), localPort (required), sessionId (required), remotePort (required). Returns: SSH tunnel info

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 46 tools

    Disambiguation2/5

    Several tool pairs have blurred boundaries: ssh_list_configured_hosts vs ssh_hosts_list both enumerate hosts, log_tail vs service_logs both read journal entries for a service, and ensure_service overlaps with service_restart/service_stop/service_status. proc_sudo vs proc_exec and ssh_host_inspect vs ssh_resolve_host also require the agent to reason about subtle policy differences rather than purpose.

    Naming Consistency4/5

    The set follows a clear domain-prefix convention (fs_*, ssh_*, service_*, proc_*, tunnel_*, file_*), which makes names scannable and mostly predictable. Minor deviations exist: get_metrics uses verb_noun while peers use noun_verb, os_detect is noun_verb amid prefix-first names, and ssh_list_sessions vs ssh_hosts_list invert the ordering within the same family.

    Tool Count2/5

    46 tools is heavy for what is essentially remote host administration, and the surface shows signs of accretion (multiple logging tools, duplicate host-listing tools, both proc_exec and proc_exec_stream, both connector_status and get_metrics). A single SSH server would be more legible with roughly half this count by merging overlapping families.

    Completeness4/5

    Coverage is broad for the domain: session lifecycle, filesystem CRUD and stats, package/service management, process control, tunnels, transfers, metrics, and a policy/planning layer. Gaps are minor — no user/group or cron/scheduled-task management, and no explicit package listing, but agents can reach those via proc_exec.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      SSH automation MCP server that enables Claude and ChatGPT to execute commands, manage files, install packages, and control services on remote servers over SSH — supporting password, key, and agent authentication.
      33
      1,267 npm
      4
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      A Model Context Protocol server for complete shell and SSH mastery, enabling command execution, interactive sessions, file transfer, and port forwarding with auditing and policy controls.
      18
      153 PyPI
      3
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol (MCP) SSH client server that provides autonomous SSH operations for GitHub Copilot and VS Code. Enable natural language SSH automation without manual prompts or GUI interactions.
      20
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      SSH-based MCP server that enables remote execution of SSH commands, file transfers, and secure server management via the MCP protocol.
      ISC