데스크톱 커맨더 MCP
간략하게 설명하자면, 두 가지 핵심이 있습니다. 터미널 명령어와 diff 기반 파일 편집입니다.
목차
이 서버는 Claude 데스크톱 앱이 컴퓨터에서 장기 실행 터미널 명령을 실행하고 MCP(Model Context Protocol)를 통해 프로세스를 관리할 수 있도록 해줍니다. + MCP 파일 시스템 서버를 기반으로 구축되어 추가 검색 및 파일 편집 기능을 제공합니다.
Related MCP server: Claude TypeScript MCP Servers
특징
출력 스트리밍으로 터미널 명령 실행
명령 시간 초과 및 백그라운드 실행 지원
프로세스 관리(프로세스 나열 및 종료)
장기 실행 명령에 대한 세션 관리
전체 파일 시스템 작업:
파일 읽기/쓰기
디렉토리 생성/나열
파일/디렉토리 이동
파일 검색
파일 메타데이터 가져오기
코드 편집 기능:
작은 변경 사항에 대한 수술 텍스트 교체
주요 변경 사항에 대한 전체 파일 다시 작성
다중 파일 지원
패턴 기반 교체
설치
먼저, Claude Desktop 앱을 다운로드하여 설치했고 npm도 설치 했는지 확인하세요.
옵션 1: Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 Desktop Commander를 자동으로 설치하려면:
지엑스피1
옵션 2: npx를 통해 설치
터미널에서 이것을 실행하세요
실행 중이면 Claude를 다시 시작하세요.
옵션 3: claude_desktop_config에 직접 추가
claude_desktop_config.json에 이 항목을 추가하세요(Mac에서는 ~/Library/Application\Support/Claude/claude_desktop_config.json에 있음):
실행 중이면 Claude를 다시 시작하세요.
옵션 4: 현지에서 결제
복제 및 빌드:
실행 중이면 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이 실패할 때 가장 적합)
검색/바꾸기 블록 형식:
예:
장기 실행 명령 처리
시간이 걸릴 수 있는 명령의 경우:
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
