경험을 바탕으로 스킬을 만들고 다듬으며, 다양한 모델 제공업체와 CLI 및 메시징 앱에서 사용할 수 있는 자기 개선형 AI 에이전트입니다.
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
Node.js를 설치한 상태에서 설정 명령을 실행합니다
npx @wonderwhy-er/desktop-commander@latest setup - 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 통계는 매일 갱신됩니다.
관련 프로젝트
터미널에서 실행되며 클라우드 API와 Ollama 같은 로컬 모델 백엔드를 지원하는 오픈소스 코딩 에이전트 CLI입니다.
원하는 LLM에 연결하고 LSP와 MCP를 지원하며 프로젝트별 세션을 제공하는 터미널 기반 AI 코딩 에이전트입니다.
터미널에서 실행하는 오픈소스 AI 코딩 에이전트로, 데스크톱·웹·에디터·채팅 인터페이스도 제공합니다.