classfang/ssh-mcp-server

해결하는 문제

ssh-mcp-server는 AI 어시스턴트(예: Claude Code 또는 Cursor)가 표준화된 인터페이스를 통해 원격 SSH 명령을 실행하고 파일을 전송할 수 있게 해주는 브리지 도구입니다. 이는 민감한 SSH 자격 증명을 AI 모델 자체에 직접 노출하지 않으면서도 AI 모델에 원격 서버를 운영할 수 있는 기능을 부여하는 문제를 해결합니다.

작동 방식

이 프로젝트는 모델 컨텍스트 프로토콜(MCP)을 구현하여 AI 어시스턴트가 execute-command, upload, download와 같은 특정 도구를 호출할 수 있도록 합니다. 서버는 다양한 인증 방법(비밀번호, 개인 키 또는 SSH 구성 파일)을 사용하여 로컬에서 SSH 연결을 관리하며, SOCKS5, HTTP 또는 HTTPS 프록시를 통해 트래픽을 라우팅할 수 있습니다. 두 가지 전송 모드를 지원합니다: 표준 명령 실행 및 SFTP를 위한 exec 모드와 대화형 세션을 위한 shell 모드(특히 배스천 호스트나 점프 서버에 유용함)입니다.

대상 사용자

AI 에이전트가 실행할 수 있는 작업에 대한 보안 제어를 유지하면서 서버 관리 워크플로우에 AI 에이전트를 통합하려는 개발자, DevOps 엔지니어 및 시스템 관리자.

주요 특징

• 자격 증명 격리: SSH 자격 증명은 로컬에 유지되며 AI 모델과 절대 공유되지 않습니다.
• 명령 안전성: 정규 표현식을 사용한 유연한 화이트리스트 및 블랙리스트 메커니즘을 포함하여 AI의 명령 범위를 제한합니다.
• 다양한 연결성: 개인 키(암호 포함), SSH 구성 재사용, 키보드 인터랙티브 인증을 통한 2FA/MFA 및 프록시 지원을 지원합니다.
• 파일 관리: 로컬 머신과 원격 서버 간의 양방향 파일 전송(업로드/다운로드)을 지원합니다.
• 다중 서버 관리: 단일 구성 파일을 통해 여러 SSH 대상을 동시에 관리할 수 있습니다.
• 명령 템플릿: 사용자를 변경하거나 컨테이너에 진입하기 위해 명령을 템플릿(예: sudo 또는 docker exec)으로 감쌀 수 있습니다.