파일 시스템 MCP 서버

파일 시스템 작업을 위한 MCP(Model Context Protocol)를 구현하는 Node.js 서버입니다.

특징

• 파일 읽기/쓰기
• 디렉토리 생성/나열/삭제
• 파일/디렉토리 이동
• 파일 검색
• 파일 메타데이터 가져오기

참고 : 서버는 args 를 통해 지정된 디렉토리 내에서만 작업을 허용합니다.

API

자원

• file://system : 파일 시스템 작업 인터페이스

도구

• 읽기_파일
  • 파일의 전체 내용 읽기
  • 입력: path (문자열)
  • UTF-8 인코딩으로 전체 파일 내용을 읽습니다.
• 여러 파일 읽기
  • 여러 파일을 동시에 읽기
  • 입력: paths (문자열[])
  • 읽기에 실패해도 전체 작업이 중단되지는 않습니다.
• 쓰기_파일
  • 새 파일을 만들거나 기존 파일을 덮어씁니다(이 경우 주의하세요)
  • 입력:
    • path (문자열): 파일 위치
    • content (문자열): 파일 내용
• 편집_파일
  • 고급 패턴 매칭 및 서식을 사용하여 선택적 편집을 수행합니다.
  • 특징:
    • 줄 기반 및 다중 줄 콘텐츠 매칭
    • 들여쓰기 보존을 통한 공백 정규화
    • 신뢰도 평가를 통한 퍼지 매칭
    • 올바른 위치 지정을 통한 여러 동시 편집
    • 들여쓰기 스타일 감지 및 보존
    • 컨텍스트가 포함된 Git 스타일 diff 출력
    • 드라이런 모드로 변경 사항 미리 보기
    • 신뢰도 점수로 실패한 매치 디버깅
  • 입력:
    • path (문자열): 편집할 파일
    • edits (배열): 편집 작업 목록
      • oldText (문자열): 검색할 텍스트(부분 문자열 가능)
      • newText (문자열): 바꿀 텍스트
    • dryRun (부울): 변경 사항을 적용하지 않고 미리 봅니다(기본값: false)
    • options (객체): 선택적 서식 설정
      • preserveIndentation (부울): 기존 들여쓰기 유지(기본값: true)
      • normalizeWhitespace (부울): 구조를 유지하면서 공백을 정규화합니다(기본값: true)
      • partialMatch (부울): 퍼지 매칭을 활성화합니다(기본값: true)
  • 드라이런에 대한 자세한 diff 및 매치 정보를 반환하고, 그렇지 않은 경우 변경 사항을 적용합니다.
  • 모범 사례: 변경 사항을 적용하기 전에 항상 dryRun을 먼저 사용하여 변경 사항을 미리 봅니다.
• 디렉토리 생성
  • 새 디렉토리를 생성하거나 디렉토리가 존재하는지 확인하세요.
  • 입력: path (문자열)
  • 필요한 경우 상위 디렉토리를 생성합니다.
  • 디렉토리가 있으면 자동으로 성공합니다.
• 목록_디렉토리
  • [FILE] 또는 [DIR] 접두사를 사용하여 디렉토리 내용을 나열합니다.
  • 입력: path (문자열)
• 이동_파일
  • 파일 및 디렉토리 이동 또는 이름 변경
  • 입력:
    • source (문자열)
    • destination (문자열)
  • 대상이 존재하면 실패합니다.
• 검색_파일
  • 재귀적으로 파일/디렉토리 검색
  • 입력:
    • path (문자열): 시작 디렉토리
    • pattern (문자열): 패턴 검색
    • excludePatterns (string[]): 패턴을 제외합니다. Glob 형식이 지원됩니다.
  • 대소문자 구분 없이 일치
  • 일치 항목의 전체 경로를 반환합니다.
• 파일_정보_받기
  • 자세한 파일/디렉토리 메타데이터 가져오기
  • 입력: path (문자열)
  • 보고:
    • 크기
    • 창조 시간
    • 수정된 시간
    • 접속 시간
    • 유형(파일/디렉토리)
    • 권한
• 허용된 디렉토리 목록
  • 서버가 액세스할 수 있는 모든 디렉토리를 나열합니다.
  • 입력이 필요하지 않습니다
  • 보고:
    • 이 서버가 읽고 쓸 수 있는 디렉토리

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

참고: 샌드박스 디렉터리를 /projects 에 마운트하여 서버에 제공할 수 있습니다. ro 플래그를 추가하면 서버에서 해당 디렉터리를 읽기 전용으로 설정합니다.

도커

참고: 모든 디렉토리는 기본적으로 /projects 에 마운트되어야 합니다.

지엑스피1

엔피엑스

짓다

Docker 빌드:

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.