MCP 파일 시스템 서버

파일 시스템 작업을 제공하는 MCP 서버입니다. 파일 탐색, 읽기, 쓰기, 분석 및 명령 실행을 지원합니다.

도구

파일 및 디렉터리 작업

• ls(path) - 디렉토리 내용 나열

• cd(path) - 작업 디렉토리 변경(~를 사용하여 홈 디렉토리 확장 지원)

• read_file(path) - 파일 내용 읽기

• write_file(path, content) - 파일에 내용 쓰기

• mkdir(path) - 디렉토리 생성

• rm(path) - 파일 또는 빈 디렉토리 제거

• rmdir(path) - 디렉토리와 내용을 재귀적으로 제거합니다.

• cp(src, dst) - 파일 또는 디렉토리 복사

• mv(src, dst) - 파일 또는 디렉토리 이동

편집 및 검색

• edit_file(path, changes) - changes가 (search_text, replace_text) 튜플 목록인 파일에 여러 검색/바꾸기 작업을 적용합니다.

• grep(pattern, path) - 파일에서 정규식 패턴 검색

분석

• summary(path) - Python(.py) 및 Markdown(.md) 파일의 요약을 생성합니다.

  • Python: 함수와 클래스 목록

  • 마크다운: 헤더(#으로 시작하는 줄)를 나열합니다.

배치 작업

• read_files(paths) - 여러 파일을 읽고 경로를 콘텐츠에 매핑하는 dict를 반환합니다.

• summarize(paths) - 여러 파일에 대한 요약을 생성하고 요약에 대한 경로를 매핑하는 dict를 반환합니다.

프로젝트 탐색

• work_on(path) - 디렉토리로 이동하고, 디렉토리 내용을 나열하고, CLAUDE.md에서 메모를 가져옵니다. 채팅 시작 시 프로젝트에 익숙해지는 데 유용합니다.

코드 품질

• ruff_check(paths) - 지정된 파일에 ruff linter를 실행합니다.

• ruff_format(paths) - ruff를 사용하여 파일 형식 지정

명령 실행

• shell_command(command, args=None, cmdline=None, timeout=30) - 셸 명령을 실행하고 출력을 캡처합니다.

  ⚠️ 보안 경고 : 이 도구는 호스트 시스템에서 임의의 명령 실행을 허용합니다. 특히 입력 소스를 신뢰할 수 없는 경우, 실행을 허용하기 전에 항상 명령을 검사하고 검증하십시오.