구조화된 도구와 기존 OpenSSH 설정을 사용하여 AI agent가 SSH를 통해 명령을 실행하고, 파일을 이동하며, 원격 머신을 감사할 수 있도록 지원합니다.
다른 이름 hypnosis/ssh-mcp-server, ssh-mcp-server, @hypnosis/ssh-mcp-server
- 스타
- 11
- Tools
- 18
- 다운로드, 30일
- 944
- 최신 버전
- 2.3.3
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- MIT
SSH MCP란?
구조화된 도구와 기존 OpenSSH 설정을 사용하여 AI agent가 SSH를 통해 명령을 실행하고, 파일을 이동하며, 원격 머신을 감사할 수 있도록 지원합니다. 18개 도구를 제공합니다. 예: ssh_exec, ssh_file_read, ssh_file_write.
프로젝트 README에서 생성된 요약
SSH MCP server 정보
이 도구를 사용하면 SSH를 통해 명령 실행, 파일 이동, 머신 감사가 가능해져 AI agent를 통한 원격 인프라 관리가 더욱 효율적으로 변합니다. 클라우드 VPS 인스턴스, 베어메탈 서버, 또는 라우터나 NAS와 같은 레거시 하드웨어를 유지 관리해야 하는 DevOps 엔지니어, 시스템 관리자 및 개발자를 위해 설계되었습니다. ASCII 테이블이나 로그 덤프로 인해 토큰을 과도하게 소비하는 로우 쉘(raw shell)을 제공하는 대신, ssh_snapshot 및 ssh_audit_baseline과 같은 특정 도구를 통해 구조화된 데이터를 제공합니다.
이 MCP server는 머신의 기존 OpenSSH 클라이언트를 활용하여 로컬에서 작동하므로, 현재 사용 중인 키, ~/.ssh/config, jump host 및 agent forwarding 설정을 그대로 따릅니다. Node.js 18 이상과 PATH에 등록된 시스템 ssh 클라이언트가 필요합니다. 사용자는 JSON 프로필 파일을 통해 호스트, 사용자 이름, 개인 키 경로를 정의하여 연결을 구성할 수 있습니다. Claude Code, Codex CLI, Cline, Gemini CLI를 포함한 다양한 MCP 클라이언트와 통합됩니다.
활용 사례
- 1원격 시스템 감사 수행AI agent가 디스크, 메모리 및 서비스 상태를 한 번에 확인하기 위해 종합적인 베이스라인 감사를 실행할 수 있습니다.
- 2서버 성능 문제 해결AI에게 특정 머신의 현재 상태에 대한 구조화된 스냅샷을 요청하여 머신의 상태가 정상인지 확인할 수 있습니다.
- 3레거시 하드웨어 파일 관리최신 scp를 지원하지 않는 오래된 라우터나 NAS 장치로 파일을 전송할 때, 서버가 자동으로 이전 프로토콜을 사용하여 파일을 전송할 수 있습니다.
- 4AI 토큰 소비 감소개발자는 로우 터미널 출력 대신 구조화된 도구를 사용하여 비용과 컨텍스트 윈도우 공간을 절약할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SSH MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SSH MCP 설치
$ claude mcp add --env 'SSH_PROFILES_FILE=<SSH_PROFILES_FILE>' ssh-mcp-server -- npx -y @hypnosis/ssh-mcp-serverCursor에 SSH MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"ssh-mcp-server": {
"command": "npx",
"args": [
"-y",
"@hypnosis/ssh-mcp-server"
],
"env": {
"SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
}
}
}
}VS Code에 SSH MCP 설치
.vscode/mcp.json
{
"servers": {
"ssh-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hypnosis/ssh-mcp-server"
],
"env": {
"SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
}
}
}
}VS Code CLI에 SSH MCP 설치
$ code --add-mcp '{"name":"ssh-mcp-server","type":"stdio","command":"npx","args":["-y","@hypnosis/ssh-mcp-server"],"env":{"SSH_PROFILES_FILE":"<SSH_PROFILES_FILE>"}}'Claude Desktop에 SSH MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"ssh-mcp-server": {
"command": "npx",
"args": [
"-y",
"@hypnosis/ssh-mcp-server"
],
"env": {
"SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
}
}
}
}Codex에 SSH MCP 설치
$ codex mcp add ssh-mcp-server --env 'SSH_PROFILES_FILE=<SSH_PROFILES_FILE>' -- npx -y @hypnosis/ssh-mcp-serverCodex config.toml에 SSH MCP 설치
~/.codex/config.toml
[mcp_servers.ssh-mcp-server] command = "npx" args = ["-y", "@hypnosis/ssh-mcp-server"] [mcp_servers.ssh-mcp-server.env] SSH_PROFILES_FILE = "<SSH_PROFILES_FILE>"
Gemini CLI에 SSH MCP 설치
$ gemini mcp add -s user -e 'SSH_PROFILES_FILE=<SSH_PROFILES_FILE>' ssh-mcp-server npx -- -y @hypnosis/ssh-mcp-serverGemini settings.json에 SSH MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"ssh-mcp-server": {
"command": "npx",
"args": [
"-y",
"@hypnosis/ssh-mcp-server"
],
"env": {
"SSH_PROFILES_FILE": "<SSH_PROFILES_FILE>"
}
}
}
}SSH MCP 도구 18
README에서 감지됨ssh_execssh_file_readssh_file_writessh_file_listssh_uploadssh_downloadssh_job_statusssh_job_outputssh_job_listssh_job_killssh_log_tailssh_log_search
| ssh_exec | — | |
| ssh_file_read | — | |
| ssh_file_write | — | |
| ssh_file_list | — | |
| ssh_upload | — | |
| ssh_download | — | |
| ssh_job_status | — | |
| ssh_job_output | — | |
| ssh_job_list | — | |
| ssh_job_kill | — | |
| ssh_log_tail | — | |
| ssh_log_search | — |
도구 18개 모두 보기도구 수 줄이기
ssh_snapshotssh_monitorssh_audit_baselinessh_tls_checkssh_disk_breakdownssh_service_status
| ssh_snapshot | — | |
| ssh_monitor | — | |
| ssh_audit_baseline | — | |
| ssh_tls_check | — | |
| ssh_disk_breakdown | — | |
| ssh_service_status | — |
구성
SSH_PROFILES_FILE필수Absolute path to the JSON file describing the servers this agent may reach.
SSH_MCP_LOG_LEVELLog verbosity: error, warn, info or debug. Defaults to info.
| 이름 | 설명 | 유형 |
|---|---|---|
| SSH_PROFILES_FILE | Absolute path to the JSON file describing the servers this agent may reach. | 필수 |
| SSH_MCP_LOG_LEVEL | Log verbosity: error, warn, info or debug. Defaults to info. |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기SSH MCP Server — Remote server tools for AI agents
It uses the OpenSSH client already on your machine: your keys, your ~/.ssh/config, your jump hosts, your agent forwarding. Nothing bundled, nothing to compile, no native bindings.
Works with Claude Code, Codex CLI, Cline, opencode, Gemini CLI, Qwen Code, Hermes and other MCP clients.
Install · Tools · Setup · Security · Roadmap · Docs · Changelog
Install in 30 seconds
No global installation required. npx downloads the package on first use:
npx -y @hypnosis/ssh-mcp-server
Add it to your MCP client — Claude Code, for example — for every project:
claude mcp add ssh -s user \
-e SSH_PROFILES_FILE="$HOME/.claude/ssh-profiles.json" \
-- npx -y @hypnosis/ssh-mcp-server
Or write it by hand — the same server in the config shape most clients share:
{
"mcpServers": {
"ssh": {
"command": "npx",
"args": ["-y", "@hypnosis/ssh-mcp-server"],
"env": {
"SSH_PROFILES_FILE": "~/.claude/ssh-profiles.json"
}
}
}
}
Then create ~/.claude/ssh-profiles.json with at least one machine:
{
"profiles": {
"production": {
"host": "server.example.com",
"username": "admin",
"privateKeyPath": "~/.ssh/your_private_key"
}
}
}
That is enough to connect.
Codex, opencode, Qwen Code and other clients are covered in Set up the SSH MCP server.
Install as a plugin
Some clients — Claude Code, for example — can take the whole thing as a plugin instead:
/plugin marketplace add hypnosis/ssh-mcp-server
/plugin install ssh-mcp-server@ssh-mcp-server
The plugin reads ~/.claude/ssh-profiles.json unless SSH_PROFILES_FILE says otherwise, so
create that file first and the server comes up with your machines already loaded.
Requirements
Node.js 18+ and a system ssh client on PATH. On Windows, use a key-based profile;
password and passphrase profiles are not currently available.
Prefer a pinned version, offline work, or one less registry check per launch:
npm install -g @hypnosis/ssh-mcp-server, then use ssh-mcp-server as the command instead
of npx.
Who this is for
- DevOps and SREs who want faster audits, incident checks and routine server work.
- Vibe coders and indie builders who ship with an AI assistant and run what they build on their own servers.
- Sysadmins and platform engineers who want structured tools instead of an unrestricted raw shell.
- Developers and small teams running their own VPS without a dedicated operations team.
- Homelab, NAS and router owners whose useful hardware has outlived its modern protocols.
Why an SSH MCP server instead of a raw shell
Fewer tokens, lower AI costs
A raw shell gives an AI agent a firehose: repeated commands, ASCII tables and log dumps. It burns tokens turning that noise into a picture of the server — your money.
Faster server debugging
Purpose-built tools batch routine checks, cap noisy output and return the part that matters. The agent spends less time translating terminal output and gets to the fix sooner.
Less guesswork, fewer AI mistakes
Structured answers say what was found, what could not be measured and what was truncated. That leaves the agent less room to fill gaps with a hallucination — and gives you fewer bad fixes, calmer deploys and more reliable code.
SSH compatibility: modern servers, legacy gear and Windows
Use your existing OpenSSH setup
No bundled SSH implementation, no native bindings, no rebuild per platform. Commands ride the
system ssh client, so your keys, your ~/.ssh/config, your jump hosts and your agent
forwarding all keep working exactly as they do in a terminal. When supported, one shared
multiplexed connection per destination means you authenticate once, not once per command.
SSH support for legacy servers, routers and NAS devices
Send a file to a router with a modern scp and you get this:
scp app.conf router:/etc/
# scp: subsystem request failed on channel 0
Nothing is broken — a current scp speaks the new protocol, and the router does not know it.
In a terminal you now go read a forum thread and come back with an extra flag. Here you do
nothing: the transfer is tried, the refusal is recognized, the old protocol is used instead,
and that machine is remembered so the next file goes straight there.
Fallbacks for older SSH clients and missing tools
Old gear gets a fallback, not a dead end. When a modern feature is missing, the server takes the older road where it can:
| Your machine | What you get |
|---|---|
| A router or NAS too small for modern file transfer | The file still lands — the old protocol is used automatically |
| A server from ten years ago | The workflow still works; it just opens a fresh connection per command instead of reusing one |
| A stripped-down image with no way to hash a file | The upload says "could not verify" instead of claiming a match nobody checked |
| A box where a tool simply is not installed | The answer says "not measured" — never a zero that reads as "nothing there" |
Built for the Model Context Protocol
Built on the official MCP SDK, TypeScript throughout, 2500+ unit tests plus a live suite that runs against real containers rather than mocks.
Raw SSH vs an SSH MCP server: the same job, both ways
SSH server health check
Situation: A deploy just went out. The server feels slow, and you do not know whether disk, memory, services, containers or errors are to blame.
Question: “Is this box healthy?”
Raw SSH
$ uptime
10:42:17 up 18 days, 3:21, 2 users, load average: 0.42, 0.31, 0.28
$ df -hT
Filesystem Type Size Used Avail Use% Mounted on
/dev/sda1 ext4 40G 35G 5.0G 87% /
overlay overlay 40G 35G 5.0G 87% /var/lib/docker/overlay2/...
$ free -h
total used free shared buff/cache available
Mem: 7.7Gi 4.9Gi 612Mi 121Mi 2.2Gi 2.5Gi
$ systemctl --failed
UNIT LOAD ACTIVE SUB DESCRIPTION
● api-worker.service loaded failed failed API background worker
$ docker ps -a
CONTAINER ID IMAGE STATUS PORTS
8e14d0b41c2a api:latest Up 3 minutes 0.0.0.0:8080->8080/tcp
65b894af2430 worker:latest Exited (1) 2 minutes ago
$ ss -tulpn
Netid State Local Address:Port Process
tcp LISTEN 0.0.0.0:22 users:(("sshd",pid=842,fd=3))
tcp LISTEN 0.0.0.0:8080 users:(("docker-proxy",pid=1942,fd=4))
$ journalctl -p err --since -1h | tail -50
Aug 20 10:39:14 prod api-worker[22104]: database connection timed out
Aug 20 10:39:14 prod systemd[1]: api-worker.service: Failed with result 'exit-code'.
That is still an abridged result. A complete check needs more commands for CPU, service
states, container counts and recent errors, each with its own output format. Worse, a box
without ss can look like it has zero listeners when the port check never ran.
Structured MCP result
ssh_snapshot({ "profile": "production" })
{
"disk_pct": 87,
"mem_pct": 64,
"cpu_pct": 12,
"load": "0.42 0.31 0.28",
"containers": 7,
"ports": 14,
"services_running": 3,
"recent_errors": 21,
"unavailable": []
}
What the agent gains
| Raw SSH | Structured MCP | Your gain |
|---|---|---|
| Several commands and ASCII tables | Named fields in one result | One call, named fields and fewer round trips |
| A missing tool can look like empty output | unavailable names what was not measured |
Less guessing and fewer bad fixes |
| You sort through disks, services and errors | The problem signals are already surfaced | Faster debugging |
A full ssh_audit_baseline result can be longer than a handful of raw command outputs —
about 1,077 tokens versus 765 in our lab measurement. The saving comes from the complete
workflow, not from making one response shorter.
In a real troubleshooting session, purpose-built tools reduced 49 separate command calls to 4 MCP calls. Every additional call starts another model turn with the accumulated conversation. Prompt caching can reduce the cost of repeated input, but new commands and their output still consume context. Fewer round trips mean fewer tokens across the session, less repeated analysis and a faster path to the answer.
Need the whole picture rather than the pulse? ssh_audit_baseline batches system, disk,
memory, ports, sshd, failed units, Docker, firewall and updates. Findings arrive as
CRITICAL / WARNING / OK; unmeasured sections are named instead of silently reading as zero.
Linux server log search
Situation: The API is timing out, but the same message may be in nginx, syslog, journald or an application log you cannot read with your normal user.
Question: “Where did that error come from?”
Raw SSH
$ grep -i "timeout" /var/log/nginx/error.log
2026/08/20 10:38:54 [error] upstream timed out while reading response header
$ grep -i "timeout" /var/log/syslog
Aug 20 10:39:14 prod api-worker[22104]: database connection timed out
$ grep -i "timeout" /var/log/app/*.log 2>/dev/null
$ journalctl -u api --since "1 hour ago" | grep -i timeout
Aug 20 10:39:14 prod api[22104]: database connection timed out after 30000ms
The third command looks clean, but 2>/dev/null also hid a permission error. "Nothing
matched" and "nothing was read" now look identical. A busy log can also return thousands of
lines and push the rest of the incident out of the agent's context.
Structured MCP result
ssh_log_search({ "profile": "production",
"path": ["/var/log/nginx/error.log", "/var/log/syslog", "/var/log/app/*.log"],
"query": "timeout", "context": 2, "since": "1h" })
{
"matches": 34,
"lines": [
{ "file": "/var/log/nginx/error.log", "line": 4821,
"text": "upstream timed out while reading response header", "context": false },
{ "file": "/var/log/nginx/error.log", "line": 4822,
"text": "client closed connection", "context": true }
],
"files_searched": 6,
"files_unreadable": ["/var/log/app/private"],
"files_skipped": 12,
"files_undated": [],
"limited": false,
"truncated": false
}
What the agent gains
| Raw SSH | Structured MCP | Your gain |
|---|---|---|
| Four searches and four outputs | One search across files and globs | Fewer tokens and round trips |
| Permission errors can disappear | files_unreadable names every missed path |
No false "logs are clean" conclusion |
| Output can grow without a useful ceiling | limited and truncated expose every cutoff |
Safer decisions from partial results |
since uses the server's clock, namesOnly: true returns only matching paths, and
ssh_log_tail reads the last N lines from several logs in one call.
Safe remote config edits
Situation: You need to replace an nginx config on a live server. A dropped connection, wrong mode or unchecked copy could leave the service with a broken file.
Question: “Can I replace this config without leaving a partial file?”
Raw SSH
$ sudo sh -c 'cat > /etc/nginx/conf.d/api.conf' <<'EOF'
server {
listen 80;
location / { proxy_pass http://127.0.0.1:8080; }
}
EOF
$ echo $?
0
Exit code zero says the shell finished. It does not prove which bytes landed, and >
truncated the old file before the first byte of the new one arrived. If the connection drops
mid-write, the service is left with a partial config.
Structured MCP result
ssh_file_write({ "profile": "production",
"files": [{ "path": "/etc/nginx/conf.d/api.conf",
"content": "server {\n listen 80;\n location / { proxy_pass http://127.0.0.1:8080; }\n}\n",
"mode": "644", "sudo": true, "verify": true }] })
{
"files": [{ "path": "/etc/nginx/conf.d/api.conf", "written": true,
"verified": "verified", "reason": null, "bytes": 79 }]
}
What the agent gains
| Raw SSH | Structured MCP | Your gain |
|---|---|---|
| The target is truncated before the copy completes | A complete temp file replaces it with one rename | No half-written config |
| Exit code only | Bytes and verification outcome are named | You know what actually landed |
| Permissions live inside shell text | sudo, mode and verify are per-file fields |
Predictable ownership and fewer quoting mistakes |
verified has three honest outcomes: verified, unavailable when the server has no hash
tool, and skipped when verification was not requested. For reads, ssh_file_read accepts a
list of paths; ssh_file_list handles globs, recursion, sizes and modes.
Run batch SSH commands with sudo
Situation: A deploy is ready, but nginx syntax, service state and recent errors must all be checked before traffic moves. One failed check should not disappear inside a combined dump.
Question: “Did every preflight check pass?”
Raw SSH
$ ssh admin@server.example.com 'sudo nginx -t'
nginx: configuration file /etc/nginx/nginx.conf test is successful
$ ssh admin@server.example.com 'sudo systemctl is-active nginx'
active
$ ssh admin@server.example.com 'sudo tail -5 /var/log/nginx/error.log'
2026/08/20 10:38:54 [error] upstream timed out while reading response header
Three connections return three unrelated outputs. If the commands are joined with ;, the
shell reports only the last exit code; if they are joined with &&, later checks disappear
after the first failure.
Structured MCP result
ssh_exec({ "profile": "production",
"command": ["nginx -t", "systemctl is-active nginx",
"tail -5 /var/log/nginx/error.log"],
"sudo": true })
{
"commands": [
{ "command": "nginx -t", "exit_code": 0, "truncated": false, "clipped_bytes": 0,
"stdout": "", "stderr": "nginx: configuration file /etc/nginx/nginx.conf test is successful\n" },
{ "command": "systemctl is-active nginx", "exit_code": 0, "truncated": false,
"clipped_bytes": 0, "stdout": "active\n", "stderr": "" },
{ "command": "tail -5 /var/log/nginx/error.log", "exit_code": 0, "truncated": false,
"clipped_bytes": 0, "stdout": "2026/08/21 09:14:02 [error] upstream timed out\n", "stderr": "" }
],
"job_id": null
}
What the agent gains
| Raw SSH | Structured MCP | Your gain |
|---|---|---|
| Three calls and unrelated outputs | One ordered command list | Fewer round trips |
| A combined shell can hide intermediate status | Every command keeps its own exit_code |
No missed failed check |
sudo and quoting are repeated in command text |
sudo applies to the whole batch |
Fewer quoting mistakes |
The destructive-command guard checks the complete list before the first command runs. If one entry is refused, every other entry is marked as not run and nothing is sent to the server.
Each command carries its own stdout and stderr. A command that ran and printed nothing
has an empty string; a command that never ran has no such field at all, so the two cannot be
confused. Output over 128 KB per command keeps both ends — the head for tables, the tail for
logs — with a seam in between naming the amount, and clipped_bytes says how much was cut.
Cutting happens on byte boundaries and steps back to the edge of a character, so a clipped
answer never carries a replacement mark.
sudo reaches the server without a terminal: the profile's answer is handed to sudo on
standard input. Which secret that is comes from sudoPassword when the profile names one and
from password otherwise — a profile that logs in by key has no login password at all, and
where a machine keeps the two apart the login one is the wrong answer. Where there is nothing
to answer with, the reply says so and names the ways out, instead of leaving sudo's own advice
about -S and askpass helpers. A command that reads its own standard input is never given the
password, which would otherwise end up mixed into the data.
Run long-lived SSH jobs
Situation: A backup or migration will run longer than the agent session. The connection may close, but you still need its state, output and exit code later.
Question: “Will this job survive the conversation?”
Raw SSH
$ ssh admin@server.example.com 'pg_dump app | gzip > /srv/backups/app.sql.gz'
client_loop: send disconnect: Broken pipe
The terminal is gone. You now have to reconnect, find the process, inspect the target file and guess whether the backup finished or stopped halfway.
Structured MCP result
ssh_exec({ "profile": "production",
"command": "pg_dump app | gzip > /srv/backups/app.sql.gz",
"detach": true })
{
"commands": [{
"command": "pg_dump app | gzip > /srv/backups/app.sql.gz",
"exit_code": null,
"truncated": false,
"timed_out": false,
"blocked": false,
"blocked_reason": null,
"not_run": false,
"warning": null
}],
"job_id": "mst0f2q1-9ab3c4d5"
}
What the agent gains
| Raw SSH | Structured MCP | Your gain |
|---|---|---|
| The job is tied to one SSH session | The remote job has a persistent id | Safe disconnects and restarts |
| Reconnecting means searching processes and files | Status and exit code have named states | No guessing whether it finished |
| Reading output again repeats old text | Output continues from a byte offset | Lower token use on long jobs |
Job state lives on the remote disk, not in this server's memory. ssh_job_status distinguishes
running, finished and lost; ssh_job_output continues from the last byte offset; and
ssh_job_kill signals the whole process group instead of only its shell.
Transfer files to legacy routers and NAS devices
Situation: A current OpenSSH client tries SFTP, but the router or NAS only understands the classic scp protocol. The file must still arrive intact and replace its target safely.
Question: “Can this old device still receive a verified file?”
Raw SSH
$ scp app.conf operator@router:/etc/app.conf
subsystem request failed on channel 0
scp: Connection closed
The usual next step is to remember the legacy flag, retry the copy and then run a separate hash command—if the device has a hash tool at all.
Structured MCP result
ssh_upload({ "profile": "router", "local_path": "./app.conf",
"remote_path": "/etc/app.conf", "sudo": true,
"mode": "644", "owner": "root:root", "verify": true })
{
"files": [{
"path": "/etc/app.conf",
"written": true,
"verified": "verified",
"reason": null,
"bytes": 1284
}]
}
What the agent gains
| Raw SSH | Structured MCP | Your gain |
|---|---|---|
| Modern SFTP mode stops at the first error | Classic scp fallback is automatic and remembered | Old gear still works |
| A successful copy does not prove integrity | SHA-256 verification has a named outcome | Corruption is not mistaken for success |
| Direct replacement can leave a partial target | A temp file is moved into place after transfer | The working file survives interruptions |
If the device has neither sha256sum nor openssl, the result says unavailable and names
the reason instead of reporting a false match. Whole directories use recursive: true and
verify their hashes in one batch.
Destructive command protection for AI agents
The guard runs locally, before a command reaches SSH. It separates operations that can be recovered from those that destroy the container holding the data, and it checks command order inside chains and batches.
Stop a destructive chain before it starts
A safe backup-and-replace sequence:
cp -r /srv/app /srv/app.bak && mv /srv/app /srv/app-old && rm -rf /srv/app
The same operations in the wrong order:
rm -rf /srv/app && cp -r /srv/app /srv/app.bak && mv /srv/app /srv/app-old
# REFUSED before the first command runs
The shell would delete the directory and only then discover that the backup source is gone.
The guard sees that later steps read a target already destroyed by an earlier step, so the
whole call stays on your machine. The same check catches
dropdb app && pg_dump app > backup.sql.
SSH MCP 질문
SSH MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SSH_PROFILES_FILE=<SSH_PROFILES_FILE>' ssh-mcp-server -- npx -y @hypnosis/ssh-mcp-server를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
SSH MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
SSH MCP는 어떤 도구를 제공하나요?
18개 도구를 제공합니다. 예: ssh_exec, ssh_file_read, ssh_file_write, ssh_file_list, ssh_upload.
별도의 SSH 설치가 필요한가요?
아니요, 기존에 사용 중인 키, 설정, jump host를 포함하여 머신에 이미 설치된 OpenSSH 클라이언트를 사용합니다.
라우터나 NAS 같은 구형 하드웨어에서도 작동하나요?
네, 최신 scp 프로토콜과 같은 최신 기능을 지원하지 않는 경우 자동으로 이전 프로토콜을 사용하는 등 레거시 장비를 위한 폴백 기능을 포함하고 있습니다.
원격 머신에 도구가 없는 경우는 어떻게 처리하나요?
잘못 해석될 수 있는 0을 반환하는 대신, 측정이 불가능함을 명시적으로 알립니다.
시스템 요구 사항은 무엇인가요?
Node.js 18 이상과 PATH에 등록된 시스템 ssh 클라이언트가 필요합니다.