Repolode
wonderwhy-er

wonderwhy-er/DesktopCommanderMCP

Claude 등 AI 클라이언트가 로컬 컴퓨터에서 터미널을 제어하고, 파일 검색과 diff 기반 편집, 문서 처리를 할 수 있게 해주는 MCP 서버입니다.

스타
10,105
포크
1,290
열린 이슈
315
마지막 커밋
22시간 전

어떤 프로젝트인가요?

Desktop Commander는 Claude Desktop, Cursor, VS Code, Gemini CLI 같은 AI 클라이언트가 서버가 실행되는 컴퓨터에서 터미널 명령을 실행하고, 프로세스를 관리하며, 파일을 다룰 수 있게 해주는 MCP(Model Context Protocol) 서버입니다. MCP Filesystem Server를 기반으로 하며 검색 및 바꾸기 방식의 파일 편집 기능을 더해, 어시스턴트가 파일 전체를 다시 작성하지 않고 코드의 필요한 부분만 수정할 수 있습니다.

셸 명령 외에도 Python, Node.js, SSH 세션 같은 대화형 프로그램을 시작하고 출력을 페이지 단위로 읽을 수 있습니다. Excel, PDF, DOCX 파일도 읽고 쓸 수 있으며, Claude Desktop용 마크다운 편집기가 포함된 파일 미리보기 패널도 제공합니다. 로컬에서 발생한 도구 호출 기록은 디스크에 저장되며, Remote Device 모드를 사용하면 웹 기반 AI 서비스가 실행 중인 로컬 컴퓨터에 명령을 보낼 수 있습니다.

이 서버는 명령 차단 목록, 허용 디렉터리, 심볼릭 링크 탐색 검사 등의 설정 가능한 안전장치를 제공합니다. 프로젝트의 보안 문서에서는 이러한 기능이 샌드박스는 아니라고 안내하며, 격리를 위해 Docker로 설치하는 방법도 제공합니다.

핵심 기능

  • 01터미널 명령과 대화형 프로그램을 실행하고, 출력을 페이지 단위로 확인하거나 백그라운드에서 실행
  • 02텍스트와 Excel 데이터를 포함한 파일 및 콘텐츠 검색
  • 03검색 및 바꾸기를 이용한 필요한 부분만의 편집과 파일 전체 다시 쓰기
  • 04Excel, PDF, DOCX 파일 읽기 및 쓰기
  • 05Claude Desktop에서 마크다운 편집기를 사용할 수 있는 파일 미리보기 패널
  • 06웹 기반 AI 서비스를 로컬 컴퓨터에 연결하는 Remote Device 모드

활용 사례

  • AI 어시스턴트가 검토하기 쉬운 작은 변경 단위로 로컬 프로젝트 전반의 코드를 리팩터링하도록 하기
  • 메모리에서 실행하는 Python 코드로 CSV, JSON 또는 Excel 파일 분석하기
  • AI 채팅에서 SSH 세션이나 개발 서버 제어하기
  • 개인 컴퓨터에서 파일 정리 또는 문서 변환 자동화하기

빠른 시작

  1. 1

    Node.js를 설치한 상태에서 설정 명령을 실행합니다

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

    Claude Desktop이 실행 중이면 다시 시작합니다

사용 전 알아둘 점

  • 샌드박스가 아닙니다. 터미널 명령을 실행하고 컴퓨터의 파일에 접근할 수 있습니다.
  • 옵션 5(로컬 체크아웃)는 git 업데이트를 수동으로 해야 합니다.

토픽

자주 묻는 질문

DesktopCommanderMCP은(는) 무엇인가요?
Claude 등 AI 클라이언트가 로컬 컴퓨터에서 터미널을 제어하고, 파일 검색과 diff 기반 편집, 문서 처리를 할 수 있게 해주는 MCP 서버입니다. Desktop Commander는 Claude Desktop, Cursor, VS Code, Gemini CLI 같은 AI 클라이언트가 서버가 실행되는 컴퓨터에서 터미널 명령을 실행하고, 프로세스를 관리하며, 파일을 다룰 수 있게 해주는 MCP(Model Context Protocol) 서버입니다. MCP Filesystem Server를 기반으로 하며 검색 및 바꾸기 방식의 파일 편집 기능을 더해, 어시스턴트가 파일 전체를 다시 작성하지 않고 코드의 필요한 부분만 수정할 수 있습니다.
DesktopCommanderMCP은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
DesktopCommanderMCP은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
DesktopCommanderMCP은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. DesktopCommanderMCP의 마지막 커밋은 2026년 10월 19일입니다.
DesktopCommanderMCP은(는) 어디에 사용할 수 있나요?
AI 어시스턴트가 검토하기 쉬운 작은 변경 단위로 로컬 프로젝트 전반의 코드를 리팩터링하도록 하기 메모리에서 실행하는 Python 코드로 CSV, JSON 또는 Excel 파일 분석하기 AI 채팅에서 SSH 세션이나 개발 서버 제어하기 개인 컴퓨터에서 파일 정리 또는 문서 변환 자동화하기
DesktopCommanderMCP는 어떻게 설치하나요?
Node.js를 설치한 상태에서 설정 명령을 실행합니다: npx @wonderwhy-er/desktop-commander@latest setup Claude Desktop이 실행 중이면 다시 시작합니다
DesktopCommanderMCP은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/wonderwhy-er/DesktopCommanderMCP

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트