Filesystem MCP Server

파일 시스템 MCP 서버

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

특징

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

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

API

자원

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

도구

• 읽기_파일
  • 파일의 전체 내용 읽기
  • 입력: path (문자열)
  • UTF-8 인코딩으로 전체 파일 내용을 읽습니다.
• 여러 파일 읽기
  • 여러 파일을 동시에 읽기
  • 입력: paths (문자열[])
  • 읽기에 실패해도 전체 작업이 중단되지는 않습니다.
• 쓰기_파일
  • 새 파일을 만들거나 기존 파일을 덮어씁니다(이 경우 주의하세요)
  • 입력:
    • path (문자열): 파일 위치
    • content (문자열): 파일 내용
• 디렉토리 생성
  • 새 디렉토리를 생성하거나 디렉토리가 존재하는지 확인하세요.
  • 입력: path (문자열)
  • 필요한 경우 상위 디렉토리를 생성합니다.
  • 디렉토리가 있으면 자동으로 성공합니다.
• 목록_디렉토리
  • [FILE] 또는 [DIR] 접두사를 사용하여 디렉토리 내용을 나열합니다.
  • 입력: path (문자열)
• 이동_파일
  • 파일 및 디렉토리 이동 또는 이름 변경
  • 입력:
    • source (문자열)
    • destination (문자열)
  • 대상이 존재하면 실패합니다.
• 검색_파일
  • 재귀적으로 파일/디렉토리 검색
  • 입력:
    • path (문자열): 시작 디렉토리
    • pattern (문자열): 패턴 검색
  • 대소문자 구분 없이 일치
  • 일치 항목의 전체 경로를 반환합니다.
• 파일_정보_받기
  • 자세한 파일/디렉토리 메타데이터 가져오기
  • 입력: path (문자열)
  • 보고:
    • 크기
    • 창조 시간
    • 수정된 시간
    • 접속 시간
    • 유형(파일/디렉토리)
    • 권한
• 나무
  • 디렉토리 구조의 계층적 JSON 표현을 반환합니다.
  • 입력:
    • path (문자열): 탐색할 디렉토리(필수)
    • depth (숫자): 통과할 최대 깊이(기본값: 3)
    • follow_symlinks (부울): 심볼릭 링크를 따를지 여부(기본값: false)
  • 파일/디렉토리 계층 구조가 포함된 형식화된 JSON을 반환합니다.
  • 파일 메타데이터(이름, 경로, 크기, 수정 시간)가 포함됩니다.
• 허용된 디렉토리 목록
  • 서버가 액세스할 수 있는 모든 디렉토리를 나열합니다.
  • 입력이 필요하지 않습니다
  • 보고:
    • 이 서버가 읽고 쓸 수 있는 디렉토리

Claude Desktop과 함께 사용

서버를 설치하세요

지엑스피1

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

특허

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