MCP Filesystem Server with unrestricted filesystem access and pwd-based relative paths
npm install mcp-filesystem-serverMCP Filesystem Server는 AI 모델이 전체 파일 시스템에 제한 없이 접근할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다. 이 서버는 상대 경로를 현재 작업 디렉토리(pwd)를 기준으로 처리하는 기능을 제공합니다.
- 전체 파일시스템 접근: 파일 시스템 전체에 제한 없이 접근 가능
- 파일 작업: 파일 읽기, 쓰기, 편집, 검색 기능
- 디렉토리 작업: 디렉토리 생성, 목록 조회, 트리 구조 탐색
- 현재 작업 디렉토리(pwd) 지원: 모든 상대 경로는 현재 작업 디렉토리를 기준으로 처리
- 바이너리 파일 지원: 바이너리 파일을 Base64로 인코딩하여 읽기 가능
``json`
{
"mcpServers": {
"filesystem_server": {
"command": "npx",
"args": [
"-y",
"mcp-filesystem-server"
]
}
}
}
1. read_file - 파일 내용 읽기 (텍스트)read_binary_file
2. - 바이너리 파일을 Base64로 인코딩하여 읽기read_multiple_files
3. - 여러 파일 한 번에 읽기write_file
4. - 파일 생성 또는 덮어쓰기edit_file
5. - 파일 내용 수정 (diff 결과 제공)create_directory
6. - 디렉토리 생성list_directory
7. - 디렉토리 내용 목록 조회directory_tree
8. - 디렉토리 구조를 트리 형태로 조회move_file
9. - 파일 또는 디렉토리 이동/이름 변경search_files
10. - 패턴으로 파일 및 디렉토리 검색 (내용 검색 옵션 포함)get_file_info
11. - 파일 또는 디렉토리 메타데이터 조회list_directory_info
12. - 파일시스템 서버 정보 표시get_pwd
13. - 현재 작업 디렉토리 조회 (상대 경로 처리 기준)
이 서버는 다양한 경로 타입을 지원합니다:
- 절대 경로: 그대로 사용 (예: /home/user/file.txt)./file.txt
- 상대 경로: 현재 작업 디렉토리(pwd)를 기준으로 처리 (예: 또는 subfolder/file.txt)~`로 시작하는 경로는 사용자의 홈 디렉토리로 확장
- 홈 디렉토리:
서버는 심볼릭 링크를 실제 대상 경로로 해석하고, 파일이나 디렉토리에 접근할 수 없는 경우 적절한 오류를 반환합니다.
- 대용량 디렉토리 처리를 위한 최대 깊이 및 결과 수 제한
- 디렉토리 트리 탐색 시 최대 깊이 설정 가능
- 파일 검색 시 내용 검색 옵션 및 최대 결과 수 제한
- 상세한 오류 메시지로 문제 해결 용이
- 파일 이동 시 덮어쓰기 옵션 지원