MCP 터널

VM 머신의 명령줄에 접근할 수 있는 간단한 MCP(Model Context Protocol) 서버입니다. 시작 시 호스트를 웹으로 터널링하여 MCP를 통해 접근할 수 있도록 합니다.

특징

• MCP를 통해 VM에서 셸 명령 실행

• VM 상호 작용을 위한 웹 기반 터미널 인터페이스

• 어디서나 VM에 액세스할 수 있도록 자동 터널링

• WebSocket 기반 실시간 통신

Related MCP server: MCP Shell Server

필수 조건

• Node.js(v18 이상)

설치 및 사용

npx로 실행(설치 없음)

지엑스피1

글로벌 설치

npm install -g mcp-cli
mcp-cli

지역 개발

# Clone repository
git clone [repository-url]
cd mcp-cli

# Install dependencies
npm install

개발

백엔드와 프런트엔드 모두에 핫 리로딩을 적용하여 개발 서버를 실행합니다.

npm run dev

건물

프로덕션을 위한 프런트엔드와 백엔드를 모두 빌드합니다.

npm run build-all

용법

1. MCP 서버를 시작합니다.

# Start with automatic tunneling
npm start

# Start without automatic tunneling
npm start -- --no-tunnel

프로젝트가 빌드되고 서버가 시작됩니다. 기본적으로 터널은 자동으로 생성됩니다. 자동 터널링을 비활성화하려면 --no-tunnel 플래그를 사용하세요.

2. 서버가 시작되어 stderr에 출력을 제공합니다(stdout에서 MCP 통신을 방해하지 않기 위해)

3. 다음 도구를 사용하여 MCP를 통해 서버와 상호 작용하세요.

사용 가능한 MCP 도구

• execute_command : VM에서 셸 명령을 실행합니다.

  • 매개변수: { "command": "your shell command" }

• start_tunnel : VM 인터페이스에 액세스하기 위한 웹 터널을 생성합니다.

  • 매개변수: { "port": 8080, "subdomain": "optional-subdomain" }

웹 인터페이스

터널을 시작한 후, 터널에서 제공하는 URL을 통해 웹 기반 터미널 인터페이스에 접속할 수 있습니다. 이 인터페이스를 통해 다음 작업을 수행할 수 있습니다.

• VM에서 직접 명령 실행

• 실시간으로 명령 출력을 확인하세요

• 웹 접속이 가능한 모든 기기에서 VM과 상호 작용

환경 변수

서버를 구성하려면 .env 파일을 만듭니다.

# Server configuration
PORT=8080

# Localtunnel configuration
LOCALTUNNEL_SUBDOMAIN=your-preferred-subdomain

보안 고려 사항

이 도구는 VM 명령줄에 직접 액세스할 수 있도록 해줍니다. 다음 보안 수칙을 고려하세요.

• 터널을 노출하기 전에 강력한 인증 메커니즘을 사용하세요.

• 적절한 검증을 통해 실행할 수 있는 명령을 제한합니다.

• 제한된 환경에서 실행하는 것을 고려하세요

• 터널을 통해 민감한 정보를 노출하지 마십시오.