AI가 터미널과 파일을 직접 다루는 데스크톱 자동화 서버
Claude와 같은 AI에게 컴퓨터의 터미널을 직접 다루게 하고, 파일을 검색하거나 수정하며, 실행 중인 프로세스와 상호작용하게 만듭니다. 이는 Model Context Protocol(MCP) 기반 서버로, AI가 사용자의 컴퓨터에서 실제 작업을 수행하도록 연결하는 다리 역할을 합니다. 기존 AI 편집기의 한계를 넘어, 호스트 클라이언트 구독을 활용하여 API 토큰 비용 없이 복잡한 개발 및 자동화 작업을 처리할 수 있습니다.
AI가 직접 다루는 데스크톱 환경
이 도구는 AI가 단순히 코드를 생성하는 것을 넘어, 사용자의 컴퓨터에서 실제 명령을 실행하고 결과를 확인하게 합니다. 터미널 명령을 실행하고, 실행 중인 프로세스에 입력을 보내며, 파일 시스템 내의 텍스트와 데이터를 검색 및 수정합니다. 특히 Python, Node.js, R 코드를 파일로 저장하지 않고 메모리에서 즉시 실행하여 데이터를 분석하거나 간단한 스크립트를 테스트할 수 있습니다. Excel, PDF, Word 문서도 외부 도구 없이 직접 읽고, 작성하고, 편집할 수 있어 문서 기반 작업도 AI가 처리할 수 있습니다.
안전장치와 원격 제어
AI가 컴퓨터를 제어할 때 발생할 수 있는 위험을 줄이기 위해 여러 안전 장치를 제공합니다. 파일 조작 시 심볼릭 링크를 통한 무단 접근을 방지하고, 실행이 위험한 명령어를 차단하는 블랙리스트 기능을 지원합니다. 완전한 격리가 필요할 경우 Docker 컨테이너 내에서 실행하여 호스트 시스템과 완전히 분리된 환경에서 작업할 수 있습니다. 또한 Remote MCP 기능을 통해 ChatGPT나 Claude 웹 버전에서도 사용자의 로컬 컴퓨터에서 명령을 실행할 수 있으며, OAuth 인증과 암호화된 통신 채널을 통해 보안을 유지합니다.
설치와 초기 설정
Claude Desktop에 설치하려면 터미널에서 npx @wonderwhy-er/desktop-commander@latest setup 명령을 실행하면 됩니다. 이 명령은 의존성 설치, 서버 빌드, Claude 설정 파일 수정까지 자동으로 처리하며, 설치가 완료되면 Claude를 재시작해야 합니다. Docker를 선호하거나 Node.js가 없는 환경에서는 Docker 설치 스크립트를 사용하거나 Docker Hub에서 이미지를 가져와 사용할 수 있습니다. Cursor, VS Code, Windsurf 등 다른 MCP 호환 클라이언트에도 JSON 설정을 추가하여 동일하게 사용할 수 있습니다.
사용 전 확인 사항
이 도구는 AI에게 시스템 명령 실행 권한을 부여하므로, 신뢰할 수 있는 AI 서비스와 함께 사용할 때 가장 효과적입니다. allowedDirectories 설정을 통해 AI가 접근할 수 있는 파일 시스템 경로를 제한할 수 있지만, 터미널 명령은 이 제한을 우회하여 다른 경로에 접근할 수 있으므로 주의가 필요합니다. Docker 격리 모드를 사용하면 이러한 위험을 최소화할 수 있습니다. 또한 원격 제어 기능을 사용할 때는 로컬 디바이스가 실행 중일 때만 명령이 수신되도록 설계되어 있으며, OAuth 인증 절차를 반드시 완료해야 합니다. 자신의 사용 패턴에 따라 자동 업데이트 옵션을 선택하고, 필요 시 remove 명령으로 깔끔하게 제거할 수 있습니다.
