npm License: MIT

AI 어시스턴트에게 세션 관리, 명령 실행, 대화형 셸, 파일 전송, 포트 포워딩 및 시스템 진단 등 완전한 SSH/SFTP 원격 작업 기능을 제공하는 MCP 서버입니다.

Claude Desktop, VS Code + GitHub Copilot 및 모든 MCP 호환 클라이언트와 함께 작동합니다.

패키지

패키지	설명
`ssh-mcp-server`	MCP 서버 (49개 도구) — 독립형 CLI 및 npm 패키지
`ssh-mcp-vscode`	VS Code 확장 프로그램 — GitHub Copilot에 서버 자동 등록

기능

세션 관리 — 비밀번호 또는 키 기반 인증을 통한 연결/연결 해제/핑
명령 실행 — stdout/stderr 캡처, 타임아웃, 종료 코드를 포함한 명령 실행
Sudo 실행 — stdin을 통해 주입된 비밀번호로 권한 상승 명령 실행 (로그에 남지 않음)
백그라운드 작업 — 폴링 및 취소 기능을 갖춘 장기 실행 명령
대화형 셸 — 읽기/쓰기/크기 조절이 가능한 PTY 셸
SFTP 작업 — 업로드, 다운로드, 읽기, 쓰기, 삭제, 목록 보기, 상태 확인
포트 포워딩 — 로컬(-L) 및 원격(-R) SSH 터널
시스템 진단 — OS, CPU, 메모리, 디스크, 네트워크, 부하, 프로세스
파일 검색 및 분석 — 파일 찾기, 내용 grep, diff, tail, 체크섬
서버 관리 — 서비스, 프로세스, cron, 네트워크 진단, 사용자
다중 호스트 워크플로우 — 명령 브로드캐스트, 호스트 간 파일 전송, 점프/배스천 연결, 스크립트 실행
세션 인텔리전스 — 시스템 스냅샷, 스냅샷 diff, 연결 북마크
컨테이너 인식 — Docker/Podman 컨테이너 목록, 로그, exec
감사 로깅 — 필터링이 가능한 NDJSON 구조화 로그

빠른 시작

독립형 (npm)

npm install -g simple-ssh-mcp-server

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": ["ssh-mcp-server"],
      "env": {
        "SSH_MCP_MAX_CONNECTIONS": "10",
        "SSH_MCP_HOST_KEY_MODE": "accept"
      }
    }
  }
}

VS Code + GitHub Copilot

SSH MCP VS Code 확장 프로그램을 설치하세요. VS Code가 실행될 때 서버가 자동으로 시작됩니다. VS Code 1.99 이상 및 GitHub Copilot이 필요합니다.

도구 (49개)

카테고리	도구
세션	`ssh_connect`, `ssh_disconnect`, `ssh_list_sessions`, `ssh_session_ping`
실행	`ssh_exec`, `ssh_sudo_exec`
백그라운드	`ssh_exec_background`, `ssh_exec_poll`, `ssh_exec_poll_list`, `ssh_exec_cancel`
셸	`ssh_shell_open`, `ssh_shell_write`, `ssh_shell_read`, `ssh_shell_resize`, `ssh_shell_close`, `ssh_shell_list`
SFTP	`ssh_sftp_list`, `ssh_sftp_upload`, `ssh_sftp_download`, `ssh_sftp_read`, `ssh_sftp_write`, `ssh_sftp_delete`, `ssh_sftp_stat`
포트 포워딩	`ssh_port_forward_local`, `ssh_port_forward_remote`, `ssh_port_forward_list`, `ssh_port_forward_remove`
파일 검색	`ssh_find`, `ssh_grep`, `ssh_diff`, `ssh_tail`, `ssh_checksum`
서버 관리	`ssh_service`, `ssh_process`, `ssh_cron`, `ssh_network`, `ssh_user`
다중 호스트	`ssh_broadcast`, `ssh_transfer`, `ssh_jump_connect`, `ssh_script`
세션 인텔리전스	`ssh_snapshot`, `ssh_snapshot_diff`, `ssh_bookmark`
컨테이너	`ssh_container_list`, `ssh_container_logs`, `ssh_container_exec`
진단	`ssh_system_info`, `ssh_get_logs`

구성

모든 설정은 환경 변수를 통해 수행됩니다:

변수	기본값	설명
`SSH_MCP_MAX_CONNECTIONS`	`10`	최대 동시 SSH 세션 수
`SSH_MCP_LOG_DIR`	`~/.ssh-mcp/logs`	감사 로그 디렉토리
`SSH_MCP_DEFAULT_TERM`	`xterm-256color`	PTY 셸의 기본 TERM
`SSH_MCP_DEFAULT_COLS`	`220`	터미널 너비
`SSH_MCP_DEFAULT_ROWS`	`50`	터미널 높이
`SSH_MCP_EXEC_TIMEOUT_MS`	`30000`	명령 타임아웃 (ms)
`SSH_MCP_HOST_KEY_MODE`	`accept`	호스트 키: `accept`, `strict`, `ask`
`SSH_MCP_ENV`	`development`	`production`은 기본적으로 `strict` 호스트 키 사용

전체 구성 참조는 서버 README를 확인하세요.

보안

Sudo 비밀번호는 stdin을 통해 주입되며, 절대 로그에 남지 않음
출력에서 ANSI 이스케이프 시퀀스 제거
출력 잘림(truncation)을 통해 무제한 메모리 사용 방지
SSH keepalive를 통해 끊긴 연결 감지
CI에서 ESLint 보안 플러그인 + Gitleaks + CodeQL + Trivy 사용

라이선스

MIT

Simple SSH MCP Server

패키지

기능

빠른 시작

독립형 (npm)

Claude Desktop

VS Code + GitHub Copilot

도구 (49개)

구성

보안

라이선스

Maintenance

Resources

Latest Blog Posts

MCP directory API