Filesystem MCP 服务

通过使用 Node.js 构建的 MCP 服务提供文件系统操作。

发布者：modelcontextprotocolmodelcontextprotocol/servers

.install .install-tabs{display:none}.install .install-panel[hidden]{display:block}@media (max-width:767px){.install .install-panel[hidden]{display:flex}}.install .install-panel+.install-panel{border-top:1px solid var(--line)}.install .install-panel-label{display:block}.install .install-all{display:none}

安装

选择客户端，然后复制命令。

Claude Code

在终端运行

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

Codex

~/.codex/config.toml

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

Cursor

项目内 .cursor/mcp.json，或 ~/.cursor/mcp.json

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

Claude Desktop

claude_desktop_config.json

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

Git

检出固定版本

git clone 'https://github.com/modelcontextprotocol/servers.git'
cd servers && git checkout bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c

任意智能体

粘贴到智能体对话中

Read the source at https://github.com/modelcontextprotocol/servers/blob/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/README.md (pinned revision bbb701e7ac1e). Explain what it does and which tools, credentials and network access it needs. Do not install or run anything until I confirm.

全部客户端说明（无需 JavaScript）

Claude Code

在终端运行

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

Codex

~/.codex/config.toml

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

Cursor

项目内 .cursor/mcp.json，或 ~/.cursor/mcp.json

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

Claude Desktop

claude_desktop_config.json

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

Git

检出固定版本

git clone 'https://github.com/modelcontextprotocol/servers.git'
cd servers && git checkout bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c

任意智能体

粘贴到智能体对话中

Read the source at https://github.com/modelcontextprotocol/servers/blob/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/filesystem/README.md (pinned revision bbb701e7ac1e). Explain what it does and which tools, credentials and network access it needs. Do not install or run anything until I confirm.

收录 ≠ 审计。代码片段依据固定版本的来源文档；运行前请检查来源和脚本。本页面不会安装任何内容。

来源记录

仓库: modelcontextprotocol/servers
来源文件: src/filesystem/README.md
固定版本: bbb701e
上游提交日期: 2026 年 10 月 11 日
最近核验: 2026 年 10 月 17 日
许可: 请查阅来源条款
指南推荐: 4

没有评分，不会自动安装。与发布者无隶属关系。

你将打开的内容

公开仓库参考。请根据原始文档了解支持的能力和配置。

如何配置

阅读固定版本 README，了解此服务提供的工具、参数和权限。
使用对应客户端的代码片段添加服务，并先替换占位路径。
重启客户端并批准该服务，先尝试无害的读取操作，再允许修改。

filesystem MCP 服务是什么？

modelcontextprotocol/servers 中的参考实现发布为 @modelcontextprotocol/server-filesystem。它使用 Node.js，通过 MCP 提供本地文件与目录操作：读取文本或媒体、列出和搜索路径、查看元数据，以及写入或编辑文件。它不是云盘，也不是二进制分析引擎。

允许目录与 MCP Roots

在启动参数中传入允许目录的绝对路径。如果客户端提供 MCP Roots，它们会替换命令行目录列表，并可能在会话中变化。用 list_allowed_directories 检查实际范围。目录限制不代表只读：write_file 和 edit_file 可以覆盖范围内的内容。

首次连接与排查

在 Install 标签选择客户端，先替换 /path/to/allowed/dir，再复制配置。从测试目录开始，读取一个非敏感文件。若因没有目录而启动失败，提供有效允许路径或配置客户端 Roots。若访问被拒绝，先核对实际目录列表与操作系统权限，再决定是否扩大访问范围。

常见问题

file system MCP server 对应哪个包？

Node.js 参考服务为 modelcontextprotocol/servers 中的 @modelcontextprotocol/server-filesystem。本页链接到固定提交的 README，并在 Install 标签提供各客户端配置。

server-filesystem MCP 是只读的吗？

不是。它同时包含读取工具和 write_file、edit_file 等可写工具。应限制允许目录，并单独检查工具权限。路径白名单不能阻止允许目录内的修改。

为什么 Filesystem MCP 无法访问目录？

检查 list_allowed_directories 和操作系统权限。客户端提供的 MCP Roots 会替换启动目录列表，因此命令行中的路径可能不再被允许。修改配置前，先确认需要访问的绝对路径。

应该给 Claude Code 添加 Filesystem MCP 吗？

仅在工作流确实需要通过 MCP 使用文件工具时添加。先检查 Claude Code 已有的文件访问能力。宿主配置可参考关联的 Claude Code MCP 指南；允许修改文件前先测试无害读取。

添加前请检查

先阅读指令并检查脚本，再决定是否执行。
检查工具权限、所需凭据和外部网络请求。
以来源许可和资源专属条款为准。