Desktop Commander MCP
터미널과 파일, 오피스 문서까지 다루는 로컬 MCP 서버
npm install -g @wonderwhy-er/desktop-commander클로드 데스크톱 같은 MCP 클라이언트에 터미널 실행과 파일 검색, 부분 치환 편집을 붙여 주는 서버입니다. 오래 도는 명령을 백그라운드로 돌리고 출력을 나눠 읽으며 프로세스를 목록으로 보고 종료시킵니다. SSH 나 데이터베이스, 개발 서버처럼 이미 떠 있는 대화형 프로세스에 입력을 넣고 응답을 받을 수 있습니다. 파일을 만들지 않고 파이썬과 Node.js, R 코드를 메모리에서 바로 실행하며 엑셀과 PDF, 워드 파일을 외부 도구 없이 읽고 씁니다. API 토큰을 따로 사지 않고 쓰던 클라이언트 구독을 그대로 씁니다.
판단
이럴 때 씁니다
- 채팅 클라이언트에서 터미널과 파일을 직접 다루고 싶을 때
- 엑셀이나 PDF, 워드 파일을 외부 도구 없이 읽고 써야 할 때
- 이미 떠 있는 SSH 나 데이터베이스 세션에 명령을 이어 넣고 싶을 때
이럴 땐 쓰지 마세요
- 편집기 안에서 코드를 고치는 것이 주목적이면 코딩 에이전트가 낫습니다
- 셸과 파일 전체 접근을 주는 도구라 권한 범위를 좁히기 어렵습니다
- 원격 접속 기능을 쓰면 로컬 기계가 외부 서비스에 열립니다
차별점
- 파일로 저장하지 않고 파이썬, Node.js, R 코드를 메모리에서 실행합니다.
- 엑셀과 PDF, 워드 파일을 외부 도구 없이 읽고 쓰고 검색합니다.
- 이미 떠 있는 대화형 프로세스에 입력을 넣고 응답을 받습니다.
워크플로
- 01패키지를 설치하고 MCP 클라이언트 설정에 등록합니다.
- 02클라이언트를 재시작해 도구가 잡히는지 확인합니다.
- 03터미널 명령이나 파일 작업을 자연어로 시킵니다.
- 04오래 도는 명령은 백그라운드로 두고 출력을 나눠 읽습니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install -g @wonderwhy-er/desktop-commander | 서버를 설치합니다. |
npx @wonderwhy-er/desktop-commander@latest setup | 클라이언트 설정에 자동으로 등록합니다. |
함정
설치 전에 확인하세요
- 셸 실행과 파일시스템 전체 접근을 주는 서버입니다. 어디까지 허용할지 클라이언트 쪽에서 정해 두어야 합니다.
- 원격 MCP 로 웹 서비스에서 부르면 로컬 기계가 그 경로로 열립니다. 세션 유지 설정을 확인해야 합니다.
- 같은 팀이 별도의 데스크톱 앱을 베타로 내고 있습니다. MCP 서버와 기능이 겹치므로 어느 쪽을 쓸지 먼저 정하는 편이 낫습니다.
비교
파일시스템 MCP 는 읽고 쓰는 것까지가 보통입니다. 이쪽은 그 위에 셸 실행과 프로세스 관리, 오피스 문서 처리를 얹어서 범위가 훨씬 넓습니다. 그만큼 편리하지만 한 서버에 주는 권한도 커지므로 승인 정책을 함께 정해야 합니다.
최근 변경
원격 기기 기능에서 세션을 기본으로 유지하도록 바꿨고, 실시간 소켓이 익명 키로 떨어지던 문제를 고쳤습니다.