SSH MCP Server

AI 클라이언트가 안전하게 서버를 조작할 수 있게 하는 SSH 기반 MCP 서버

표준화된 MCP 도구를 통해 원격으로 명령 실행과 파일 전송을 수행하며, 웹 관리 콘솔과 Windows 트레이 애플리케이션이 내장되어 있습니다.

할 수 있는 일

Claude Code, Cursor 등 MCP 프로토콜을 지원하는 AI 클라이언트를 SSH 서버에 연결하면 AI가 다음 작업을 수행할 수 있습니다:

• ⚙️ 명령 실행 —— 원격 운영, 로그 조사, 서비스 관리

• 📤 파일 업로드 / 📥 다운로드 —— 구성 배포, 로그 수집, 대용량 파일 이어받기

• 🖥️ 다중 서버 관리 —— 프로젝트 → 환경 → 호스트 3단계 트리, 한 번 구성하면 어디서나 사용 가능

두 가지 사용 형태를 필요에 따라 선택하세요:

Related MCP server: sshops

✨ 핵심 기능

연결 기능

• 🔐 다양한 인증: 비밀번호 / 개인 키(암호화된 개인 키 포함) / SSH Agent / 키보드 인터랙티브 2FA

• 🔗 SOCKS5 및 HTTP(S) 프록시, 점프 호스트 네트워크 통과

• 🚄 이중 전송 모드:

  • exec —— 명령마다 하나의 채널, 표준 Linux 호스트

  • shell —— 영구 세션 + 마커 프로토콜, 배스천 호스트 / 점프 호스트에 적합

• ⏱️ 연결 / 명령 / SFTP 3단계 타임아웃을 독립적으로 제어 가능; 대용량 파일은 fastPut/fastGet 분할 동시 전송

보안 정책

• 명령어 화이트리스트 / 블랙리스트(정규식), 호스트 레벨과 글로벌 레벨 이중 필터

• 로컬 및 원격 경로 화이트리스트로 파일 전송 범위 제한

• 전체 감사 로그: 명령, 출력, 전송 기록 추적 가능

웹 관리 콘솔

• 프로젝트-환경-호스트 3단계 시각적 관리, 연결 드래그 앤 드롭 정렬

• 연결 테스트, JSON 일괄 가져오기/내보내기, ~/.ssh/config 자동 재사용

• 정기 백업 스냅샷 및 원클릭 복원; MCP 클라이언트(Claude Code 등) 원클릭 등록

• 라이트/다크 테마, 시스템 설정 자동 전환

Windows 데스크톱 애플리케이션

• 🎯 트레이 전용 단일 exe: SSH 서비스, MCP Server, Admin 정적 사이트가 모두 내장되어 Node.js 의존성 없음

• 시작 시 자동 실행, 종료 시에도 상주; '관리 페이지 열기'로 시스템 기본 브라우저 실행

• 🔄 온라인 자동 업데이트: 내장 minisign 서명 검증, 새 버전 자동 감지 후 자동 업그레이드

📸 화면 미리보기

연결 관리 —— 3단계 트리로 모든 호스트 관리:

시스템 페이지 —— 서비스 상태 및 MCP 클라이언트 원클릭 등록:

🚀 빠른 시작

방법 1: Windows 데스크톱 애플리케이션

Releases에서 SSH-MCP-Server_x.x.x_x64-setup.exe를 다운로드하여 설치합니다. 시작 후 시스템 트레이에 상주하며, 트레이 메뉴의 '관리 페이지 열기'로 웹 콘솔에 진입합니다.

이미 설치한 사용자는 이후 업그레이드가 자동으로 완료되며 수동 조작이 필요 없습니다.

방법 2: npm 패키지(stdio MCP Server)

# 全局安装
npm install -g @sieop/ssh-mcp-server

MCP 클라이언트에 등록합니다(Claude Code 예시):

claude mcp add ssh-server -- ssh-mcp-server --host your.server.com --username root --password YOUR_PWD

또는 JSON 구성 파일을 직접 작성합니다:

{
  "mcpServers": {
    "ssh-server": {
      "command": "npx",
      "args": ["-y", "@sieop/ssh-mcp-server", "--host", "your.server.com", "--username", "root", "--password", "YOUR_PWD"]
    }
  }
}

구성 파일 및 다중 연결 모드도 지원합니다. 자세한 내용은 docs/migration.md와 CLI 도움말(--help)을 참조하세요.

방법 3: 소스 코드 빌드

git clone https://github.com/SIE-Operations-and-Maintenance-Team/ssh-mcp-server.git
cd ssh-mcp-server && npm install

npm run build                 # 构建 Node 版
npm test                      # 运行测试
npm --prefix admin-web install && npm --prefix admin-web run build   # 构建管理台前端
npm run tauri:build           # 构建 Windows 桌面应用（需 Rust 工具链）

🧰 MCP 도구 목록

🏗️ 아키텍처

┌─ Windows 桌面应用（Tauri 2 纯托盘单 exe）──────────────────┐
│                                                            │
│  SSH 连接池 ── MCP StreamableHTTP (/mcp)                   │
│      │                                                     │
│  Admin API (/admin/api/*) ── 内嵌静态站点 (/admin/)        │
│                                                            │
└────────────────── 系统默认浏览器打开管理页 ────────────────┘

Node 版（npm 包）：stdio MCP Server ＋ 可选 --admin 启动同一套 Web 管理台

핵심 모듈: src/services/ssh-connection-manager.ts(SSH 코어), src/server/(Fastify Admin 서비스), src-tauri/(Rust 데스크톱 셸), admin-web/(React 관리 콘솔).

📋 추가 문서

• 사용 마이그레이션 가이드 —— 각 클라이언트 연동 구성

• 업데이트 로그

📄 라이선스

ISC © SIE Operations and Maintenance Team

이 프로젝트는 classfang/ssh-mcp-server에서 파생되었으며, 이를 기반으로 리팩터링하고 확장했습니다.