Filesystem MCP Server 配置与使用说明

支持客户端

• Claude Desktop
• Cursor
• VS Code / Cline

安装命令

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

配置示例

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

权限范围与安全提示

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

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

风险评分：3/10

常见报错

路径不存在

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

权限不足

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

EACCES permission denied

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

来源

• 官方文档 / 仓库

最近核验：2026-05-18。客户端版本和配置格式可能变化，使用前请以官方文档为准。

相关工具