Filesystem (reference server)

Filesystem (reference server) 설치 방법

npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir

제 역할을 하는 곳

• 업무용 노트북에서 Claude Desktop을 쓰는 운영 관리자

  회의록과 보고서 폴더를 어시스턴트가 읽고 정리하게 하기

  ~/Documents/ops처럼 허용 디렉터리 하나를 넣은 npx 설정을 추가합니다. 모델은 요약하고, move_file로 이름을 바꾸고, 파일을 다시 쓸 수 있습니다. 삭제 도구는 없지만 write_file이 덮어쓰므로, 폴더는 동기화되거나 백업되는 위치에 두십시오.

• MCP SDK로 문서 처리 에이전트를 만드는 개발자

  파일 도구를 직접 만들지 않고 에이전트에 샌드박스된 파일 접근 권한 주기

  mcp/filesystem Docker 이미지를 실행해 작업 공간은 /projects 아래에 바인드 마운트하고 참조 데이터는 읽기 전용으로 마운트합니다. 주석이 붙은 도구 13개 덕분에 직접 만들고 보안을 챙기는 수고를 덜 수 있습니다. 비용은 없지만 프로젝트는 프로덕션 지원을 제공하지 않습니다.

• 데스크톱 50대에 쓸 MCP 서버를 승인하는 보안 엔지니어

  filesystem 서버를 허용해도 안전한지 판단하기

  2.0.0 이상을 요구하고(0.6.3과 2025.7.1 이전 버전에는 샌드박스 탈출 CVE가 있습니다), 프로젝트 폴더만 허용하고 홈 디렉터리는 절대 허용하지 않으며, 사용자가 읽기만 하면 되는 경우에는 읽기 전용 Docker 마운트를 우선합니다.

도입 전 확인할 점

설정

Claude Desktop 설정에 npx -y @modelcontextprotocol/server-filesystem /path/to/dir를 넣거나, VS Code의 원클릭 설치 버튼, 또는 mcp/filesystem Docker 이미지를 씁니다. npx에는 Node.js 24 이상이 필요하며, 클라이언트를 다시 시작하면 바로 도구를 쓸 수 있습니다.

연동

도구 13개입니다. 읽기 전용 아홉 개(read_text_file, read_media_file, read_multiple_files, list_directory, list_directory_with_sizes, directory_tree, search_files, get_file_info, list_allowed_directories)와 쓰기 네 개(create_directory, write_file, edit_file, move_file)입니다. 로컬 전용이며, 모든 도구가 openWorldHint를 false로 설정합니다.

데이터와 개인정보

허용 디렉터리 안의 모든 것을 사용자 권한으로 읽고 씁니다. 클라이언트가 모델에 보내는 것 말고는 아무것도 컴퓨터 밖으로 나가지 않습니다. Docker ro 마운트로 폴더를 읽기 전용으로 만들 수 있습니다. 심각도 높음 샌드박스 탈출 권고 두 건, CVE-2025-53109와 CVE-2025-53110은 2025년 7월에 수정되었습니다.

대규모 사용 시 비용

무료이며 MIT 라이선스입니다. 운영 비용은 컨텍스트입니다. 요청마다 도구 정의 13개가 들어가고, 큰 폴더에서는 directory_tree와 read_multiple_files의 결과가 컨텍스트 창을 빠르게 채울 수 있습니다.

제한

쓰기는 충돌 시 원자성을 보장하지 않고, 대상이 이미 있으면 move_file이 실패하며, 삭제 도구가 없습니다. 2026-07-28 클라이언트에서는 Roots로 허용 목록을 바꿀 수 없고, 디렉터리 없이 시작한 서버는 모든 호출에 오류로 응답합니다.

Filesystem (reference server) 대안

Git (reference server)

Model Context Protocol·버전 관리

3.8/5

로컬 저장소에서 모델에게 Git 도구 12개(status, diff, commit, branch, log)를 주는 공식 MCP 레퍼런스 서버입니다.

Memory (reference server)

Model Context Protocol·메모리 및 추론

3.5/5

엔터티와 관계로 된 로컬 지식 그래프로 모델에게 지속적인 메모리를 주는 공식 MCP 참조 서버입니다.

Filesystem (reference server): 자주 묻는 질문

Filesystem (reference server), 쓸 만한 가치가 있습니까?

채팅 앱에 폴더 하나만 딱 넘겨주는 가장 깔끔한 방법입니다. 다만 MCP 프로젝트 스스로 이를 교육용 예제라고 부른다는 점을 기억해야 합니다. 평점은 5점 만점에 4.1점입니다.

Filesystem (reference server)의 가격은 얼마입니까?

무료 오픈소스입니다.

Filesystem (reference server)의 단점은 무엇입니까?

MCP 프로젝트가 프로덕션용이 아닌 레퍼런스라고 설명합니다; 덮어쓰기가 충돌 시 원자성을 보장하지 않습니다; 2.0.0은 Node.js 24 이상이 필요합니다; 파일 도구가 내장된 코딩 에이전트에서는 불필요합니다.

Filesystem (reference server)에 적합한 사람은 누구입니까?

로컬 폴더 한두 개에 통제된 접근이 필요한 Claude Desktop 또는 맞춤 에이전트 사용자입니다.

팀이나 프로덕션 환경에서 Filesystem (reference server)의 비용은 얼마입니까?

무료이며 MIT 라이선스입니다. 운영 비용은 컨텍스트입니다. 요청마다 도구 정의 13개가 들어가고, 큰 폴더에서는 directory_tree와 read_multiple_files의 결과가 컨텍스트 창을 빠르게 채울 수 있습니다.

Filesystem (reference server)에 회사 데이터를 맡겨도 안전합니까?

허용 디렉터리 안의 모든 것을 사용자 권한으로 읽고 씁니다. 클라이언트가 모델에 보내는 것 말고는 아무것도 컴퓨터 밖으로 나가지 않습니다. Docker ro 마운트로 폴더를 읽기 전용으로 만들 수 있습니다. 심각도 높음 샌드박스 탈출 권고 두 건, CVE-2025-53109와 CVE-2025-53110은 2025년 7월에 수정되었습니다.

Filesystem (reference server)의 가장 좋은 대안은 무엇입니까?

저희가 리뷰한 것 중 가장 가까운 대안은 Git (reference server) 및 Memory (reference server)입니다.

답변 확인일: 2026년 10월 22일.