데스크톱 커맨더 MCP

간략하게 설명하자면, 두 가지 핵심이 있습니다. 터미널 명령어와 diff 기반 파일 편집입니다.

이 서버는 Claude 데스크톱 앱이 컴퓨터에서 장기 실행 터미널 명령을 실행하고 MCP(Model Context Protocol)를 통해 프로세스를 관리할 수 있도록 해줍니다. + MCP 파일 시스템 서버를 기반으로 구축되어 추가 검색 및 파일 편집 기능을 제공합니다.

특징

출력 스트리밍으로 터미널 명령 실행
명령 시간 초과 및 백그라운드 실행 지원
프로세스 관리(프로세스 나열 및 종료)
장기 실행 명령에 대한 세션 관리
전체 파일 시스템 작업:
- 파일 읽기/쓰기
- 디렉토리 생성/나열
- 파일/디렉토리 이동
- 파일 검색
- 파일 메타데이터 가져오기
- 코드 편집 기능:
- 작은 변경 사항에 대한 수술 텍스트 교체
- 주요 변경 사항에 대한 전체 파일 다시 작성
- 다중 파일 지원
- 패턴 기반 교체

설치

먼저, Claude Desktop 앱을 다운로드하여 설치했고 npm도 설치 했는지 확인하세요.

옵션 1: Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Desktop Commander를 자동으로 설치하려면:

지엑스피1

옵션 2: npx를 통해 설치

터미널에서 이것을 실행하세요

npx @wonderwhy-er/desktop-commander setup

실행 중이면 Claude를 다시 시작하세요.

옵션 3: claude_desktop_config에 직접 추가

claude_desktop_config.json에 이 항목을 추가하세요(Mac에서는 ~/Library/Application\Support/Claude/claude_desktop_config.json에 있음):

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

실행 중이면 Claude를 다시 시작하세요.

옵션 4: 현지에서 결제

복제 및 빌드:

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

실행 중이면 Claude를 다시 시작하세요.

설정 명령은 다음을 수행합니다.

종속성 설치
서버를 빌드하세요
Claude의 데스크톱 앱 구성
필요한 경우 Claude의 구성에 MCP 서버를 추가합니다.

용법

서버는 다음과 같은 도구 범주를 제공합니다.

터미널 도구

execute_command : 구성 가능한 시간 제한으로 명령 실행
read_output : 장기 실행 명령의 출력을 가져옵니다.
force_terminate : 실행 중인 명령 세션을 중지합니다.
list_sessions : 활성 명령 세션 보기
list_processes : 시스템 프로세스 보기
kill_process : PID로 프로세스 종료
block_command / unblock_command : 명령 블랙리스트 관리

파일 시스템 도구

read_file / write_file : 파일 작업
create_directory / list_directory : 디렉토리 관리
move_file : 파일 이동/이름 변경
search_files : 패턴 기반 파일 검색
get_file_info : 파일 메타데이터

편집 도구

edit_block : 수술 텍스트 교체 적용(파일 크기의 20% 미만 변경 사항에 가장 적합)
write_file : 전체 파일 재작성(20% 이상의 대규모 변경 사항 또는 edit_block이 실패할 때 가장 적합)

검색/바꾸기 블록 형식:

filepath.ext
<<<<<<< SEARCH
existing code to replace
=======
new code to insert
>>>>>>> REPLACE

예:

src/main.js
<<<<<<< SEARCH
console.log("old message");
=======
console.log("new message");
>>>>>>> REPLACE

장기 실행 명령 처리

시간이 걸릴 수 있는 명령의 경우:

execute_command 시간 초과 후 초기 출력으로 반환됩니다.
명령은 백그라운드에서 계속됩니다
PID와 함께 read_output 사용하여 새 출력을 얻습니다.
필요한 경우 force_terminate 사용하여 중지하세요.

모델 컨텍스트 프로토콜 통합

이 프로젝트는 MCP 파일 시스템 서버를 확장하여 다음을 지원합니다.

Claude Desktop의 로컬 서버 지원
전체 시스템 명령 실행
프로세스 관리
파일 작업
검색/바꾸기 블록을 사용한 코드 편집

Claude MCP를 탐구하는 일환으로 제작되었습니다: https://youtube.com/live/TlbjFDbl5Us

진행 중인 작업 및 TODO

현재 개발 중이거나 계획 중인 기능은 다음과 같습니다.

더 나은 코드 검색 ( 진행 중 ) - 컨텍스트 인식 결과를 통한 향상된 코드 탐색
더 나은 구성 ( 진행 중 ) - 허용된 경로, 명령 및 셸 환경에 대한 설정이 개선되었습니다.
Windows 환경 수정 ( 진행 중 ) - Windows 플랫폼에 특정한 문제 해결
Linux 개선 사항 ( 진행 중 ) - 다양한 Linux 배포판과의 호환성 향상
WSL 지원 - Linux 통합을 위한 Windows 하위 시스템
SSH 지원 - 원격 서버 명령 실행
설치 문제 해결 가이드 - 설치 문제에 대한 포괄적인 도움말

메디아

다음 리소스를 통해 이 프로젝트에 대해 자세히 알아보세요.

기사

MCP를 탑재한 Claude가 Cursor와 Windsurf를 대체했습니다. 어떻게 이런 일이 가능했을까요? - 모델 컨텍스트 프로토콜 기능을 탑재한 Claude가 개발자 워크플로우를 어떻게 변화시키고 있는지 자세히 살펴봅니다.

동영상

Claude Desktop Commander 비디오 튜토리얼 - Commander를 효과적으로 설정하고 사용하는 방법을 시청하세요.

지역 사회

도움을 받고, 피드백을 공유하고, 다른 사용자와 소통하려면 Discord 서버 에 가입하세요.

기여하다

이 프로젝트가 유용하다고 생각되시면 GitHub에서 ⭐ 별점을 주세요! 다른 사람들이 이 프로젝트를 알아보고 더 발전하는 데 도움이 됩니다.

커뮤니티 여러분의 참여를 환영합니다! 버그를 발견하셨든, 기능 요청이 있으시든, 또는 코드 기여를 원하시든, 다음과 같은 방법으로 도움을 주실 수 있습니다.

버그를 발견하셨나요? github.com/wonderwhy-er/ClaudeComputerCommander/issues 에서 이슈를 열어주세요.
기능 아이디어가 있으신가요? 이슈 섹션에 기능 요청을 제출해 주세요.
코드에 기여하고 싶으신가요? 저장소를 포크하고, 브랜치를 생성한 후 풀 리퀘스트를 제출하세요.
질문이나 토론이 있으신가요? GitHub 토론 탭에서 토론을 시작하세요.

크고 작음에 관계없이 모든 기여를 환영합니다!

이 도구가 귀하의 업무 흐름에 유용하다고 생각되면 이 프로젝트를 지원해 주시기 바랍니다.

특허

MIT

Desktop Commander MCP

Integrations