Filesystem
officialfilesystemlocalmaintained by Anthropic ↗
Anthropic이 관리하는 공식 MCP 서버 모음(modelcontextprotocol/servers)에 포함된 Filesystem MCP다. Claude가 로컬 파일시스템에 직접 접근할 수 있게 해준다. 설정에서 허용한 디렉토리 경로 범위 안에서만 동작하며, 그 밖의 경로는 접근이 차단된다. 별도 API 키나 외부 서비스 없이 Node.js만 있으면 바로 실행할 수 있다.
무엇을 할 수 있나
파일 읽기 / 쓰기
텍스트 파일을 읽거나 새 내용을 작성한다. 코드 파일, 설정 파일, 마크다운 문서 등을 Claude가 직접 열어보거나 수정할 수 있다.
디렉토리 탐색
폴더 구조를 탐색하고 파일 목록을 가져온다. 재귀적 트리 구조 조회, 파일 크기 포함 목록 등을 지원한다.
파일 이동 / 이름 변경
파일이나 폴더를 다른 경로로 이동하거나 이름을 바꾼다. 일괄 파일 정리, 리팩토링 후 파일 구조 재편 등에 쓸 수 있다.
파일 생성 / 삭제
새 파일이나 폴더를 만들거나 삭제한다. 중첩 디렉토리 생성도 지원한다.
파일 검색
Glob 패턴으로 파일을 찾는다. 여러 파일에 걸친 특정 패턴을 Claude가 직접 탐색할 수 있다.
메타데이터 조회
파일 크기, 수정 날짜, 권한 등의 메타데이터를 확인한다.
이미지 / 미디어 파일 읽기
이미지, 오디오 등 미디어 파일을 Base64로 읽는다.
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json 에 아래 내용을 추가한다. 경로는 접근을 허용할 실제 디렉토리로 교체하세요. 여러 경로를 args 배열에 추가할 수 있습니다.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/your-username/Desktop",
"/Users/your-username/Documents"
]
}
}
}Claude Code
터미널에서 아래 명령어를 실행한다. 경로는 허용할 디렉토리로 교체하세요.
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir
기본값은 현재 프로젝트에만 등록(local). 모든 프로젝트에서 쓰려면 --scope user를 추가하세요.