Filesystem MCP：给 AI 开一个受控的文件沙箱

一句话定位：MCP 官方参考实现，让 AI 在你的授权目录里安全地读改写文件。

Filesystem MCP Server 是 Model Context Protocol 官方仓库里最基础的参考服务器，本质是一个跑在你本地的 Node.js 程序，通过标准协议把「文件操作」能力安全地交给 Claude、Cursor、VS Code 等支持 MCP 的客户端。它和直接给 AI 整块磁盘权限不同，Filesystem 采用白名单机制——只有你在配置里显式列出的目录，AI 才能访问，其余一律不可见。这正是它被几乎所有 MCP 教程列为「第一个该装的服务器」的原因：零配置、无需 API Key、权限边界清晰。对想在本地让 AI 帮忙整理文档、批量改文件、又不想开放整块硬盘的人，它是入场首选。

连接器信息

核心能力

沙箱化目录访问：你在启动时用命令行参数或 MCP Roots 指定允许目录，服务器只在白名单内工作，list_allowed_directories 可随时查看当前开放范围。场景举例：只把「桌面/下载」开放给 AI 整理照片，系统盘与项目代码库完全不可见，权限边界可控。

完整的文件读写工具集：内置 13 个工具，覆盖读文本/媒体、写文件、按模式精准编辑、建目录、列目录、递归搜索、移动重命名、目录树、取元数据等。场景举例：让 AI「把桌面所有图片挪进 Images 文件夹」或「搜出含某关键词的文档」，它分步调用工具完成，每步都经你批准。

零密钥、纯本地运行：不需要任何 API Key 或账号，也不联网（官方明确说明工具不会触碰外部系统）。场景举例：在断网环境或内网机器上，只要装了 Node.js，就能让本地助手安全地代管文件，数据不出本机。

动态授权（MCP Roots）：支持 Roots 的客户端会把当前工作区目录自动下发给服务器，运行时变更目录无需重启。场景举例：在 VS Code 里切到不同项目文件夹，Filesystem 自动跟随新工作区，不用反复改配置。

跨客户端通用：同一份 stdio 命令在 Claude Desktop、Cursor、Claude Code、VS Code、Windsurf、Cline 都能跑，配置格式几乎一致。场景举例：团队里有人用 Cursor、有人用 Claude Code，一份配置模板全组复用，降低上手成本。

使用上手

1. 准备运行环境：确认已装 Node.js 18+（终端执行 node --version 验证），Filesystem 通过 npx 拉取，无需手动安装包。
2. 编写客户端配置：在客户端的 MCP 配置文件里加入下方 JSON，把路径换成你实际想开放的目录。

3. 配置示例（Claude Desktop / Cursor 通用）：

   {
     "mcpServers": {
       "filesystem": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/Desktop", "/Users/yourname/Downloads"]
       }
     }
   }

   Windows 若直接用 npx 失败，可把 command 改为 cmd、args 首项为 /c 再接 npx；VS Code 用 .vscode/mcp.json 且键名为 servers。

4. 重启客户端并验证：完全退出再打开客户端，在对话框点开连接器列表应能看到 filesystem 及其工具；试着说「把桌面的一首诗存成 txt」，AI 会先请求授权再执行。

优点与不足

• 优点：零配置、无需 API Key；白名单沙箱权限边界清晰；官方参考实现、生态最成熟（周下载约 15 万）；跨客户端通用。
• 不足：不支持文件监听，外部改了文件 AI 不会主动感知（有读到旧内容风险）；星标无法单独统计（它寄居在 servers 单体仓库）；没有内置只读模式（可用 Docker 挂载只读模拟）。

许可证与获取

适合谁

适合想让本地 AI 助手安全代管文件的个人与团队，尤其看重权限隔离、不想开放整块磁盘的人。需要实时监控文件变化或跨机器共享目录的场景，它不够用，得另配同步类 server。和「全磁盘开放」的粗暴方案比，Filesystem 用白名单换来了可控性，是更稳妥的默认选择。

下载与访问

• 仓库：https://github.com/modelcontextprotocol/servers
• npm 直装：npx -y @modelcontextprotocol/server-filesystem /你的目录
• 客户端文档：https://modelcontextprotocol.io/docs/develop/connect-local-servers

本文属于「连接器」分类的 AI 资源专栏，更多评测见分类页。