文件系统 MCP 服务器

Integrations

Supports containerized deployment through Docker, enabling filesystem operations in an isolated environment with volume mounts for controlled access to host directories.
Implements filesystem operations through Node.js, allowing reading, writing, and manipulation of files and directories in a controlled environment.

文件系统 MCP 服务器 [MOD]

Node.js 服务器实现了模型上下文协议 (MCP)，用于文件系统操作。此代码来自https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem 。

变化：

独立，不依赖根项目
可以使用正则表达式来定义允许的目录
正斜杠 (/) 和反斜杠 () 之间的自动转换

特征

读/写文件
创建/列出/删除目录
移动文件/目录
搜索文件
获取文件元数据

注意：服务器只允许在通过args指定的目录内进行操作。

API

资源

file://system ：文件系统操作接口

工具

读取文件
- 读取文件的完整内容
- 输入： path （字符串）
- 使用 UTF-8 编码读取完整的文件内容
读取多个文件
- 同时读取多个文件
- 输入： paths （字符串[]）
- 读取失败不会停止整个操作
写入文件
- 创建新文件或覆盖现有文件（请谨慎操作）
- 输入：
  - path （字符串）：文件位置
  - content （字符串）：文件内容
编辑文件
- 使用高级模式匹配和格式进行选择性编辑
- 特征：
  - 基于行和多行的内容匹配
  - 保留缩进的空白规范化
  - 多个同时编辑且定位正确
  - 缩进样式检测和保存
  - 带有上下文的 Git 风格差异输出
  - 使用试运行模式预览更改
- 输入：
  - path （字符串）：要编辑的文件
  - edits （数组）：编辑操作列表
    - oldText （字符串）：要搜索的文本（可以是子字符串）
    - newText （字符串）：要替换的文本
  - dryRun （布尔值）：预览更改而不应用（默认值：false）
- 返回试运行的详细差异和匹配信息，否则应用更改
- 最佳实践：在应用更改之前，务必先使用 dryRun 预览更改
创建目录
- 创建新目录或确保其存在
- 输入： path （字符串）
- 如果需要，创建父目录
- 如果目录存在，则静默成功
列表目录
- 列出带有 [FILE] 或 [DIR] 前缀的目录内容
- 输入： path （字符串）
移动文件
- 移动或重命名文件和目录
- 输入：
  - source （字符串）
  - destination （字符串）
- 如果目标存在则失败
搜索文件
- 递归搜索文件/目录
- 输入：
  - path （字符串）：起始目录
  - pattern （字符串）：搜索模式
  - excludePatterns (string[])：排除任何模式。支持 Glob 格式。
- 不区分大小写的匹配
- 返回匹配的完整路径
获取文件信息
- 获取详细的文件/目录元数据
- 输入： path （字符串）
- 返回：
  - 尺寸
  - 创建时间
  - 修改时间
  - 访问时间
  - 类型（文件/目录）
  - 权限
列出允许的目录
- 列出服务器允许访问的所有目录
- 无需输入
- 返回：
  - 该服务器可以读取/写入的目录

与 Claude Desktop 一起使用

将其添加到您的claude_desktop_config.json中：

注意：您可以通过将沙盒目录挂载到/projects来为服务器提供沙盒目录。添加ro标志将使服务器只读该目录。

Docker

注意：所有目录必须默认挂载到/projects 。

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
        "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
        "mcp/filesystem",
        "/projects"
      ]
    }
  }
}

NPX

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

与 VS Code 一起使用

为了快速安装，请单击下面的安装按钮...

如需手动安装，请将以下 JSON 块添加到 VS Code 中的“用户设置 (JSON)”文件中。您可以按下Ctrl + Shift + P并输入Preferences: Open Settings (JSON)来完成此操作。

或者，您可以将其添加到工作区中名为.vscode/mcp.json的文件中。这样您就可以与其他人共享该配置。

请注意.vscode/mcp.json文件中不需要mcp键。

您可以通过将沙盒目录挂载到/projects来为服务器提供沙盒目录。添加ro标志将使服务器将该目录设置为只读。

Docker

注意：所有目录必须默认挂载到/projects 。

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--mount", "type=bind,src=${workspaceFolder},dst=/projects/workspace",
          "mcp/filesystem",
          "/projects"
        ]
      }
    }
  }
}

NPX

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "${workspaceFolder}"
        ]
      }
    }
  }
}

建造

Docker 构建：

docker build -t mcp/filesystem -f src/filesystem/Dockerfile .

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

Node.js 服务器为文件系统操作实现模型上下文协议 (MCP)，并为允许的目录提供正则表达式支持，使 AI 助手能够通过自然语言安全地读取、写入和操作文件。

Related MCP Servers

Filesystem MCP Serverofficial
modelcontextprotocol
-
security
A
license
-
quality
Node.js server implementing Model Context Protocol (MCP) for filesystem operations.
Last updated -
30,124
47,105
JavaScript
MIT License
Filesystem MCP Server
Legaltime
-
security
F
license
-
quality
Node.js server implementing Model Context Protocol for filesystem operations, allowing Claude to read, write, and manipulate files and directories in specified locations.
Last updated -
30,124
JavaScript
MCP Local File Reader
sworddut
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.
Last updated -
47
1
JavaScript
MIT License
HWP MCP Server
jkf87
-
security
F
license
-
quality
A Node.js server that implements Model Context Protocol (MCP) for controlling HWP (Korean word processor) documents, allowing AI assistants like Claude to create and manipulate Hangul documents.
Last updated -
27
Python

View all related MCP servers