mcp-server-filesystem

LLM 에이전트를 위한 파일 시스템 작업을 도구로 노출하는 MCP 서버로, FastMCP로 구축되었습니다. mcprack MCP 프록시/카탈로그 도구를 위한 경량·저의존성 테스트 서버로 설계되었습니다.

구성

자격 증명은 필요하지 않습니다. 모든 구성은 환경 변수를 통해 이루어지며, 시작 시 한 번만 읽습니다:

도구에 제공된 모든 경로는 FS_ROOT를 기준으로 확인되며, .. 또는 심볼릭 링크를 통해 벗어나려 하면 거부됩니다. 이는 애플리케이션 수준의 경계이며, 강화된 샌드박스( chroot/mount 네임스페이스)가 아닙니다.

Related MCP server: ab_mcp

도구

읽기 전용: list_dir, read_file, stat, exists, glob_search.

변경 가능(FS_READONLY=false 필요): write_file, mkdir, delete, move, copy.

사용 방법

권장 — VitexSoftware 저장소의 Debian 패키지

sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg -o /usr/share/keyrings/vitexsoftware-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/vitexsoftware-archive-keyring.gpg] http://repo.vitexsoftware.com trixie main backports" \
  | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update
sudo apt install mcp-server-filesystem

backports 구성 요소는 필수이며 선택 사항이 아닙니다: python3-mcp(python3-fastmcp의 의존성)는 python3-jsonschema >= 4.20.0이 필요한데, 이는 Debian trixie가 main에서 제공하는 버전보다 최신입니다 — backports에서만 사용할 수 있습니다. 이것이 없으면 apt install이 python3-jsonschema에 대한 충족되지 않은 의존성 오류로 실패합니다.

이렇게 하면 python3-fastmcp와 mcp-server-filesystem이 한 번에 설치됩니다.

대안 — pip

pip install -e .
export FS_ROOT=/path/to/sandbox
mcp-server-filesystem

mcprack 통합

mcprack에 이 서버를 등록할 때:

• 명령: mcp-server-filesystem

• 환경 변수: FS_ROOT=/path/to/sandbox, FS_READONLY=false (쓰기가 필요한 경우)

mcprack은 이를 stdio 하위 프로세스로 실행하고 사용자별로 HTTP를 통해 프록시합니다.

개발

pytest