클로드 데스크톱 커맨더 MCP

npm 다운로드 대장간 배지

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

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

특징

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

Related MCP server: Claude Desktop Commander 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

기여하다

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

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

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

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