SSH - policy-gated remote access MCP Server
SSH MCP Server is a security-first Model Context Protocol server that gives LLM agents controlled SSH access to remote hosts - with command classification, policy-based authorization, human-in-the-loop approval, and full audit logging. Its 14 documented tools cover sftp, session, command, file. It runs locally over stdio via the published package.
People who work with sftp, session and command and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-09-17 · ★ 743 · #6 OF 945 MAINTAINED OTHER · VERIFIED 2026-09-18
MIT · TypeScript servers · how we verify → /methodology
01 · Install SSH - policy-gated remote access
before you install - you'll need
Set SSH_MCP_PASSWORD, SSH_AUTH_SOCK before connecting.
Claude Code
claude mcp add tufantunc-ssh-mcp -- npx -y ssh-mcp Claude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"tufantunc-ssh-mcp": {
"command": "npx",
"args": [
"-y",
"ssh-mcp"
]
}
}
} Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license MIT - declared in the repository
npm package ssh-mcp - unscoped; check the name against the project README before installing
registry namespace io.github.tufantunc is GitHub-verified and matches the repo owner
03 · What SSH - policy-gated remote access can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can discover available hosts and connection status, list active sessions per host, create a named interactive (stateful) or background session, and close a session. A background session's command is signalled (INT/TERM/KILL) before its channel is dropped.
Capability map
Tools grouped from the project's README - what SSH - policy-gated remote access lets an agent do.
Sftp
5 tools - e.g. Upload a file via SFTP; Download a file via SFTP; List a remote directory, bounded in entries and bytes
sftp-upload · sftp-download · sftp-list · sftp-upload-file · sftp-download-file
read & search
3 tools - e.g. Discover available hosts and connection status; List active sessions per host; Read output from background sessions (e.g., tail -f)
list-connections · list-sessions · read-session-output
Command
3 tools - e.g. Execute allowlisted read-only commands (ls, cat, grep, ...); Execute arbitrary commands (destructive/privileged need approval, unless approvalPolicy = "auto"); Execute with sudo (needs approval, unless…
read-command · run-command · privileged-command
Open
1 tool - e.g. Create a named interactive (stateful) or background session
open-session
Close
1 tool - e.g. Close a session. A background session's command is signalled (INT/TERM/KILL) before its channel is dropped
close-session
Signal
1 tool - e.g. Send INT/TERM/KILL to a remote PID
signal-process
Latest releases
v2.9.0 · 2026-09-17
Thanks @tufantunc! - Feature: three streaming SFTP tools - sftp-list, sftp-upload-file and sftp-download-file (#185). · sftp-upload/sftp-download carry file contents as a tool argument and a tool response, which is…
v2.8.3 · 2026-09-15
Thanks @tufantunc! - Test: the text of every tool description is now asserted against what a client actually receives, so a reword cannot ship unnoticed. · A description is what the model reads when deciding whether…
v2.8.2 · 2026-09-14
Thanks @tufantunc! - Fix: sftp-download can no longer hang forever on a server that accepts its size probe and never answers. · Before downloading, the tool asks the server how big the file is, so it can refuse an…
04 · Who maintains SSH - policy-gated remote access
SSH - policy-gated remote access is maintained by tufantunc. We track 2 MCP servers from tufantunc - 2 actively maintained, 745 combined GitHub stars, oldest repo from Apr 2025. Full record: all servers from tufantunc.
05 · Facts
- repository
- github.com/tufantunc/ssh-mcp
- category
- other - ranked #6 of 945 actively-maintained other servers as of 2026-09-18.
- release cadence
- 10+ releases in the last 90 days (latest 2026-09-17)
- registry
- io.github.tufantunc/ssh-mcp (active, first published 2026-08-24 · 13 versions)
- packages
- npm:ssh-mcp
06 · SSH - policy-gated remote access FAQ
Is SSH - policy-gated remote access still maintained?
Yes - as of 2026-09-18, its last commit was 2026-09-17 and it shipped 10+ releases in the last 90 days. We re-verify nightly.
What can SSH - policy-gated remote access do?
With this server connected, an agent can discover available hosts and connection status, list active sessions per host, create a named interactive (stateful) or background session, and close a session. A background session's command is signalled (INT/TERM/KILL) before its channel is dropped.
How do I install SSH - policy-gated remote access?
Run `npx -y ssh-mcp`. The README documents 2 environment variables (SSH_MCP_PASSWORD, SSH_AUTH_SOCK) to set first. Set SSH_MCP_PASSWORD, SSH_AUTH_SOCK before connecting. You can also paste the ready-made client config above.
Does SSH - policy-gated remote access run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to SSH - policy-gated remote access
Alternatives to SSH - policy-gated remote access
Maintained other servers if SSH - policy-gated remote access isn't the fit.
- Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,552 · 2026-09-17
- Server Commands An MCP server to run arbitrary commands ★ 39,038 · 2026-09-11
- basebalance.cloud - x402 RPC & MCP gateway USDC-gated Base JSON-RPC: free 10 req/min, $0.50 per 10k. Failover, cache, /mcp, ledger. ★ 6,432 · 2026-08-26
- Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 5,069 · 2026-09-15
- Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,470 · 2026-09-18
- Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,681 · 2026-09-17
More MCP servers to compare · Ook Cite · Mkdocs MCP · Hilan MCP · Ui5 MCP Server · Webcomponents MCP Server
More TypeScript MCP servers · Partner Center MCP · Figma MCP Go · Tuteliq MCP Server · Tychi MCP · Type Atlas · see all