Skip to main content
Glama
Sign In
deenesjakoruzh
bhayanak

Simple SSH MCP Server

by bhayanak
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

CI 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에 서버 자동 등록

Related MCP server: ssh-mcp

기능

  • 세션 관리 — 비밀번호 또는 키 기반 인증을 통한 연결/연결 해제/핑

  • 명령 실행 — 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-remote-ssh

    faizbawa
    A
    license
    A
    quality
    A
    maintenance
    MCP server giving AI agents full SSH access with persistent sessions, structured command output, SFTP file transfer, and port forwarding.
    18
    68 PyPI
    12
    MIT

  • ssh-mcp

    slepp
    A
    license
    A
    quality
    B
    maintenance
    An MCP server that gives AI agents SSH access to remote machines through your local OpenSSH client, enabling remote command execution, file transfer, persistent shell sessions, and port forwarding.
    17
    521 PyPI
    33
    MIT

  • R-Shell

    MageGojo
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server enabling AI assistants to securely operate remote servers via persistent SSH sessions, with tools for command execution, file transfer, directory listing, and system monitoring.
    4
    MIT

  • sshand

    muradmalik23
    A
    license
    A
    quality
    C
    maintenance
    An open MCP server that gives any AI agent SSH access to remote Linux/Unix machines — shell commands, file read/write, and SFTP transfers.
    11
    43 PyPI
    MIT