Skip to Content

SSH

SSH 프로토콜을 통해 원격 서버에 연결하여 명령어를 실행하고 결과를 조회할 수 있습니다.

주요 기능

  • 원격 서버 명령어 실행
  • 실시간 명령어 출력 조회
  • 안전한 SSH 연결
  • 다양한 인증 방식 지원

기본 정보

인증 방식

SSH 키 또는 비밀번호를 사용하여 인증합니다.

입력 파라미터

  • Host (필수): SSH 서버 호스트 주소
  • Port (필수): SSH 서버 포트 (기본값: 22)
  • Username (필수): SSH 사용자명
  • Password (선택): SSH 비밀번호
  • Private Key (선택): SSH 개인 키
  • Passphrase (선택): SSH 개인 키가 암호화된 경우, 암호화 해제를 위한 암호문구

지원하는 MCP 도구

명령어 실행 도구

execute_command

원격 SSH 서버에서 셸 명령어를 실행하고 출력을 반환합니다.

입력 파라미터:

  • command (필수): 실행할 셸 명령어

지원하는 명령어 예시:

  • 시스템 정보 조회: uname -a, whoami, pwd
  • 파일 시스템 작업: ls -la, cat filename, find /path -name "*.txt"
  • 프로세스 관리: ps aux, top, htop
  • 네트워크 진단: ping hostname, netstat -an, ss -tuln
  • 시스템 모니터링: df -h, free -m, uptime
  • 로그 조회: tail -f /var/log/syslog, journalctl -f

사용 예시

예를 들어,

  • Prompt로 “원격 서버의 디스크 사용량을 확인해줘” 라고 입력하면,
  • LLM은 MCP를 통해 execute_command 도구를 호출하여 df -h 명령어를 실행합니다.
  • 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.

주의사항

  • SSH 인증 정보는 안전하게 보관하세요.
  • 프로덕션 서버에서는 읽기 전용 명령어 사용을 권장합니다.
  • 시스템 변경 명령어 실행 시 신중하게 검토하세요.
  • 네트워크 연결 상태를 확인하세요.
  • 명령어 실행 권한을 적절히 제한하세요.
Last updated on