프로젝트 소개

Desktop Commander MCP는 주로 Claude Desktop과 같은 AI 어시스턴트에 강력한 터미널 제어, 파일 시스템 작업, 코드 편집 기능을 확장하는 Model Context Protocol(MCP) 서버입니다. MCP 파일 시스템 서버를 기반으로 구축되어 AI 기반 개발 및 자동화를 위한 포괄적인 도구 키트를 제공합니다. 주요 기능은 다음과 같습니다: 터미널 및 프로세스 관리: 출력 스트리밍으로 터미널 명령 실행, 실행 중인 프로세스 관리(목록, 상호작용, 종료), 세션 관리로 장기 실행 명령 처리, 명령 시간 초과 및 백그라운드 실행 지원. 컨텍스트 오버플로를 방지하기 위한 프로세스 출력 페이지 매김 기능 포함. 파일 시스템 작업: 텍스트, Excel, PDF, DOCX 파일 읽기/쓰기를 포함한 전체 파일 시스템 액세스, 구성 가능한 깊이로 디렉터리 생성 및 나열, 파일 이동, 파일 및 콘텐츠 검색(Excel 콘텐츠 포함), 파일 메타데이터 검색. Unix tail과 같은 음수 오프셋 파일 읽기 및 컨텍스트 오버플로 보호 기능이 있는 재귀 디렉터리 나열 지원. 코드 편집: 작은 변경을 위한 정밀 텍스트 교체, 큰 변경을 위한 전체 파일 재작성, 여러 파일 지원, vscode-ripgrep을 사용한 패턴 기반 교체로 재귀 코드 검색 지원. 다중 형식 지원: Excel 파일(.xlsx, .xls, .xlsm)에 대한 읽기, 쓰기, 편집, 검색 기능 기본 지원; 텍스트 추출, 마크다운에서 생성, 수정 기능을 갖춘 PDF 지원; 정밀 XML 편집 및 마크다운에서 DOCX 변환 기능을 갖춘 DOCX 지원. 코드 실행: 파일을 저장하지 않고 메모리에서 코드 실행(Python, Node.js, R)으로 CSV, JSON, Excel 파일의 즉각적인 데이터 분석 가능. 안전 및 구성: 심볼릭 링크 탐색 방지, 명령 차단 목록, 완전한 샌드박싱을 위한 선택적 Docker 격리와 같은 안전 가드레일 포함. 서버 구성 관리는 차단된 명령, 기본 셸, 허용 디렉터리, 파일 읽기/쓰기 줄 제한을 포함하여 재시작 없이 동적 변경을 허용합니다. 설치 유연성: npx(자동 업데이트), bash 스크립트 설치 프로그램, Smithery, 수동 구성, 로컬 체크아웃, Docker 설치(Node.js 불필요)를 포함한 여러 설치 방법. Claude Desktop, Cursor, Windsurf, VS Code/GitHub Copilot, Cline, Roo Code, Claude Code, Trae, Kiro, Codex, JetBrains AI Assistant, Gemini CLI, Augment Code, Qwen Code 등과 호환됩니다. 원격 MCP: 클라우드 서비스에 안전하게 연결되는 경량 원격 장치를 통해 ChatGPT, Claude 웹 및 기타 AI 서비스에서 원격 액세스를 지원하여 사용자 제어를 유지하면서 명령을 로컬에서 실행할 수 있습니다. 파일 미리보기 UI: 렌더링된 마크다운, 인라인 이미지, 확장 가능한 콘텐츠, 내장 마크다운 편집기, 빠른 "폴더에서 열기" 액세스로 Claude Desktop에서 시각적 파일 미리보기 제공. 감사 및 기록: 활성 기록 파일을 제한하기 위해 크기 기반 회전/트리밍으로 로컬 도구 호출 기록 및 감사 로그 제공. 또한 이 도구는 신규 사용자를 위한 지능형 온보딩을 포함하여 다운로드 정리, 데이터 파일 분석, CI/CD 설정, 코드베이스 탐색과 같은 일반적인 작업에 대한 초보자 친화적인 튜토리얼과 예제를 제공합니다.