Filesystem 설정

시작할 때 지정한 디렉터리 안에서 로컬 파일을 읽고, 쓰고, 검색하고, 이동합니다.

게시자

MCP Steering Group 공식

로컬 실행

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

전송 방식

stdio

인증

없음. 인수 또는 roots를 통해 전달된 디렉터리로 접근이 제한됩니다.

접근 가능한 항목

허용된 디렉터리 내의 파일을 읽고 씁니다.

라이선스

MIT (existing) / Apache-2.0 (new contributions)

소스

github.com/modelcontextprotocol/servers/tree/main/src/filesystem

상태

활성

설치

이 서버는 클라이언트의 자식 프로세스로 내 컴퓨터에서 실행됩니다. 명령에서 사용하는 런타임이 필요합니다. 예를 들어 npx에는 Node.js, uvx에는 uv, Docker에는 Docker가 필요합니다. Environment에 나열된 변수도 준비해야 합니다.

Claude Code

claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir

Cursor

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/dir"
      ]
    }
  }
}

Codex

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]

다른 클라이언트용 설정 →