SSH 원격 MCP 서버

MCP(Model Context Protocol)를 통해 MCP 호환 클라이언트에 대한 SSH 원격 액세스를 제공합니다.

빠른 시작

1. 설치:

   pip install -r requirements.txt

2. Claude Desktop 또는 Claude Code에 MCP 추가:

   MCP 설정을 사용하고 명령어를 다음과 같이 설정하세요:

   python3 adremote-mcp/ssh_mcp_server.py

   또는

   python.exe adremote-mcp/ssh_mcp_server.py

3. Codex에 MCP 추가:

   Codex MCP 설정에 동일한 서버를 추가하세요:

   python3 adremote-mcp/ssh_mcp_server.py

4. 자동 설정:

   이 저장소를 다운로드하고, Claude 또는 Codex를 실행한 다음, 이 폴더를 전역 MCP 서버로 추가하도록 요청하세요. 그 후에는 채팅에서 직접 사용할 수 있습니다.

기능

• Windows 및 Linux의 MCP 호환 클라이언트와 작동

• SSH를 통해 원격 서버에 연결

• 기본 SSH 점프 호스트 / 배스천(bastion) 지원

• 원격으로 명령 실행

• SFTP를 통한 파일 업로드/다운로드

• 다중 연결 관리

• 상태 모니터링

사용 예시

비밀번호로 연결:

Connect to 192.168.1.100 with username ubuntu and password mypass

또는 더 짧은 형식:

ssh 192.168.1.100:22 ubuntu mypass

MCP는 먼저 사용자 이름과 비밀번호로 SSH 연결을 테스트합니다. 로그인이 성공하면 SSH 키를 생성하거나 설치하고, 키 기반 자격 증명을 로컬에 저장하며, 비밀번호는 저장하지 않습니다. 비밀번호는 처음 연결할 때만 사용됩니다.

일회성 세션에 비밀번호로 연결:

ssh 192.168.1.100:22 ubuntu mypass, save_credentials false

이 방식은 라이브 연결만 유지합니다. 재사용 가능한 자격 증명은 저장되지 않으며 자동 키 부트스트랩도 시도되지 않습니다.

저장된 이름을 사용하여 나중에 연결:

ssh saved-name

첫 번째 성공적인 설정 후에는 저장된 자격 증명 이름을 사용하여 다시 연결하기만 하면 됩니다.

점프 호스트를 통해 연결:

ssh_connect 또는 ssh_save_credentials에서 `jump_