Desktop Commander MCP 프로젝트 상세 소개

프로젝트 개요

Desktop Commander MCP는 모델 컨텍스트 프로토콜 (MCP) 기반의 서버 도구로, Claude Desktop 애플리케이션을 위해 특별히 설계되었습니다. MCP 프로토콜을 통해 Claude에게 터미널 제어, 파일 시스템 검색 및 차별화된 파일 편집 기능을 제공하여 Claude를 강력한 개발 도우미로 변환합니다.

이 프로젝트는 MCP 파일 시스템 서버의 기능을 확장하여 개발자가 Claude를 통해 로컬 시스템을 직접 조작하고, 명령을 실행하고, 파일을 관리하고, 코드 편집을 수행할 수 있도록 하여 기존 AI 편집기의 능력 범위를 뛰어넘습니다.

핵심 기능 특징

🖥️ 터미널 작업

• 명령 실행: 터미널 명령을 실행하고 출력 스트리밍 지원
• 시간 초과 제어: 구성 가능한 명령 시간 초과 및 백그라운드 실행 지원
• 프로세스 관리: 실행 중인 프로세스 목록 및 종료
• 세션 관리: 장시간 실행 명령의 세션 관리 지원
• 다중 Shell 지원: bash, zsh, powershell 등 다양한 Shell 환경 지원

📁 파일 시스템 작업

• 파일 읽기/쓰기: 완전한 파일 읽기 및 쓰기 기능
• 디렉토리 관리: 파일 및 디렉토리 생성, 목록, 이동
• 파일 검색: 파일 이름 기반 검색 기능
• 메타데이터 획득: 파일 및 디렉토리의 상세 정보 획득
• 다중 파일 지원: 여러 파일을 동시에 읽기
• URL 내용 읽기: URL에서 텍스트 및 이미지 내용 읽기 지원

✏️ 코드 편집 능력

• 정확한 대체: 소폭 수정에 대한 외과 수술식 텍스트 대체
• 완전 재작성: 대폭 변경에 대한 완전한 파일 재작성
• 다중 파일 지원: 여러 파일을 동시에 편집
• 패턴 대체: 패턴 기반 텍스트 대체
• 코드 검색: vscode-ripgrep을 사용하여 재귀적 코드 또는 텍스트 검색

⚙️ 서버 구성 관리

• 구성 획득/설정: 구성 값 획득 및 설정
• 일괄 업데이트: 한 번에 여러 설정 업데이트
• 동적 구성: 서버 재시작 없이 구성 변경 가능
• 보안 제어: 특정 명령 차단 및 디렉토리 접근 제한 지원

설치 방법

방법 1: NPX 빠른 설치 (권장)

npx @wonderwhy-er/desktop-commander@latest setup

방법 2: macOS 자동 설치

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

방법 3: Smithery 설치

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

방법 4: 수동 빌드 설치

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup

주요 도구 분류

구성 관리 도구

• get_config: 전체 서버 구성 획득
• set_config_value: 특정 구성 값 설정

터미널 도구

• execute_command: 터미널 명령 실행
• read_output: 실행 세션의 새로운 출력 읽기
• force_terminate: 실행 세션 강제 종료
• list_sessions: 모든 활성 터미널 세션 목록
• list_processes: 모든 실행 중인 프로세스 목록
• kill_process: PID를 통해 프로세스 종료

파일 시스템 도구

• read_file: 로컬 파일 또는 URL 내용 읽기
• read_multiple_files: 여러 파일을 동시에 읽기
• write_file: 파일 내용 완전 대체
• create_directory: 디렉토리 생성
• list_directory: 디렉토리 상세 목록 획득
• move_file: 파일 및 디렉토리 이동 또는 이름 변경
• search_files: 이름으로 파일 찾기
• search_code: 파일 내용에서 텍스트/코드 패턴 검색
• get_file_info: 파일 또는 디렉토리 상세 메타데이터 획득

텍스트 편집 도구

• edit_block: 외과 수술식 텍스트 대체 적용

기술적 장점

기존 IDE 도구와 비교

• 전체 시스템 솔루션: IDE 환경에 국한되지 않고 전체 운영 체제 조작 가능
• 완전한 파일 읽기: Claude가 파일을 분할 처리하지 않고 완전하게 읽을 수 있음
• 다중 프로젝트 지원: 여러 프로젝트를 동시에 처리 가능
• 일회성 실행: 변경 사항을 한 번에 실행하여 반복적인 확인 감소

비용 효율성

• Claude Desktop의 표준 Pro 구독 ($20/월) 기반
• 추가 API 호출 비용 불필요
• 자동 업데이트 메커니즘, NPX 또는 Smithery 설치 시 최신 버전 자동 획득

사용 시나리오

개발 시나리오

• 복잡한 코드베이스 탐색 및 이해
• 차트 및 문서 생성
• 시스템 간 작업 자동화
• 다중 프로젝트 동시 작업
• 정확한 코드 수정

보안 특성

• 구성 가능한 차단 명령 목록
• 허용 디렉토리 접근 제어
• 프로세스 관리 및 모니터링
• 구성 지속성 및 검증