Filesystem MCP Server Configuration & Usage Guide

Supported Clients

• Claude Desktop
• Cursor
• VS Code / Cline

Installation Command

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

Configuration Example

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/Documents"
      ]
    }
  }
}

Permission Scope & Security Notes

可读写指定目录下的文件，建议限制到具体项目目录

• file-read
• file-write
• directory-list

Risk Score：3/10

Common Errors

路径不存在

确认 args 中的路径存在且拼写正确

权限不足

检查操作系统文件权限，macOS 可能Required在系统设置中授权

EACCES permission denied

尝试使用绝对路径，避免 ~ 符号

Sources

• Official Documentation / Repository

Recently Verified：2026-05-18。Client versions and configuration formats may change. Please refer to official documentation before use.

Related Tools