MCP 파일 시스템 파이썬

지정된 디렉토리에 있는 파일에 대한 안전하고 읽기 전용 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다.

특징

• `file://` URI 체계를 사용하여 파일을 MCP 리소스로 노출합니다.

• MCP 도구를 통해 파일 검색 기능을 제공합니다.

• .gitignore 패턴을 존중합니다.

• 경로 횡단 보호를 포함한 보안 기능

• MIME 유형 감지

Related MCP server: MCP Filesystem Python

설치

UV 사용:

지엑스피1

용법

서버를 실행합니다:

uv run src/filesystem/server.py /path/to/directory

Claude 데스크톱 통합

구성 예제

Claude Desktop의 예제 구성은 `examples` 디렉토리에서 찾을 수 있습니다.

• `examples/claude_desktop_config.json`: macOS/Linux용 예제

• `examples/claude_desktop_config_windows.json`: Windows용 예제

다음 위치에 파일을 저장해야 합니다.

• macOS: `~/라이브러리/애플리케이션 지원/클로드/클로드_데스크탑_config.json`

• Windows: `%AppData%\Claude\claude_desktop_config.json`

다음 사항을 확인하세요.

1. 경로를 실제 경로로 바꾸세요

2. macOS/Linux의 경우 슬래시(`/`)를 사용하고 Windows의 경우 백슬래시(`\\`)를 사용합니다.

3. 절대 경로를 사용하세요(상대 경로가 아님)

개발

1. 저장소를 복제합니다

2. 가상 환경 생성 및 동기화 요구 사항, uv sync

특허

MIT