MCP Filesystem Server

MCP Filesystem Server는 AI 모델이 전체 파일 시스템에 제한 없이 접근할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다. 이 서버는 상대 경로를 현재 작업 디렉토리(pwd)를 기준으로 처리하는 기능을 제공합니다.

기능

• 전체 파일시스템 접근: 파일 시스템 전체에 제한 없이 접근 가능
• 파일 작업: 파일 읽기, 쓰기, 편집, 검색 기능
• 디렉토리 작업: 디렉토리 생성, 목록 조회, 트리 구조 탐색
• 현재 작업 디렉토리(pwd) 지원: 모든 상대 경로는 현재 작업 디렉토리를 기준으로 처리
• 바이너리 파일 지원: 바이너리 파일을 Base64로 인코딩하여 읽기 가능

설치

{
    "mcpServers": {
        "filesystem_server": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-filesystem-server"
            ]
        }
    }
}

사용 가능한 도구

1. read_file - 파일 내용 읽기 (텍스트)
2. read_binary_file - 바이너리 파일을 Base64로 인코딩하여 읽기
3. read_multiple_files - 여러 파일 한 번에 읽기
4. write_file - 파일 생성 또는 덮어쓰기
5. edit_file - 파일 내용 수정 (diff 결과 제공)
6. create_directory - 디렉토리 생성
7. list_directory - 디렉토리 내용 목록 조회
8. directory_tree - 디렉토리 구조를 트리 형태로 조회
9. move_file - 파일 또는 디렉토리 이동/이름 변경
10. search_files - 패턴으로 파일 및 디렉토리 검색 (내용 검색 옵션 포함)
11. get_file_info - 파일 또는 디렉토리 메타데이터 조회
12. list_directory_info - 파일시스템 서버 정보 표시
13. get_pwd - 현재 작업 디렉토리 조회 (상대 경로 처리 기준)

경로 처리

이 서버는 다양한 경로 타입을 지원합니다:

• 절대 경로: 그대로 사용 (예: /home/user/file.txt)
• 상대 경로: 현재 작업 디렉토리(pwd)를 기준으로 처리 (예: ./file.txt 또는 subfolder/file.txt)
• 홈 디렉토리: ~로 시작하는 경로는 사용자의 홈 디렉토리로 확장

서버는 심볼릭 링크를 실제 대상 경로로 해석하고, 파일이나 디렉토리에 접근할 수 없는 경우 적절한 오류를 반환합니다.

성능 및 안전 기능

• 대용량 디렉토리 처리를 위한 최대 깊이 및 결과 수 제한
• 디렉토리 트리 탐색 시 최대 깊이 설정 가능
• 파일 검색 시 내용 검색 옵션 및 최대 결과 수 제한
• 상세한 오류 메시지로 문제 해결 용이
• 파일 이동 시 덮어쓰기 옵션 지원