MCP 터널
VM 머신의 명령줄에 접근할 수 있는 간단한 MCP(Model Context Protocol) 서버입니다. 시작 시 호스트를 웹으로 터널링하여 MCP를 통해 접근할 수 있도록 합니다.
특징
MCP를 통해 VM에서 셸 명령 실행
VM 상호 작용을 위한 웹 기반 터미널 인터페이스
어디서나 VM에 액세스할 수 있도록 자동 터널링
WebSocket 기반 실시간 통신
Related MCP server: MCP SSH Agent
필수 조건
Node.js(v18 이상)
설치 및 사용
npx로 실행(설치 없음)
지엑스피1
글로벌 설치
지역 개발
개발
백엔드와 프런트엔드 모두에 핫 리로딩을 적용하여 개발 서버를 실행합니다.
건물
프로덕션을 위한 프런트엔드와 백엔드를 모두 빌드합니다.
용법
MCP 서버를 시작합니다.
프로젝트가 빌드되고 서버가 시작됩니다. 기본적으로 터널은 자동으로 생성됩니다. 자동 터널링을 비활성화하려면 --no-tunnel 플래그를 사용하세요.
서버가 시작되어 stderr에 출력을 제공합니다(stdout에서 MCP 통신을 방해하지 않기 위해)
다음 도구를 사용하여 MCP를 통해 서버와 상호 작용하세요.
사용 가능한 MCP 도구
execute_command: VM에서 셸 명령을 실행합니다.매개변수:
{ "command": "your shell command" }
start_tunnel: VM 인터페이스에 액세스하기 위한 웹 터널을 생성합니다.매개변수:
{ "port": 8080, "subdomain": "optional-subdomain" }
웹 인터페이스
터널을 시작한 후, 터널에서 제공하는 URL을 통해 웹 기반 터미널 인터페이스에 접속할 수 있습니다. 이 인터페이스를 통해 다음 작업을 수행할 수 있습니다.
VM에서 직접 명령 실행
실시간으로 명령 출력을 확인하세요
웹 접속이 가능한 모든 기기에서 VM과 상호 작용
환경 변수
서버를 구성하려면 .env 파일을 만듭니다.
보안 고려 사항
이 도구는 VM 명령줄에 직접 액세스할 수 있도록 해줍니다. 다음 보안 수칙을 고려하세요.
터널을 노출하기 전에 강력한 인증 메커니즘을 사용하세요.
적절한 검증을 통해 실행할 수 있는 명령을 제한합니다.
제한된 환경에서 실행하는 것을 고려하세요
터널을 통해 민감한 정보를 노출하지 마십시오.