mcp/filesystem

文件系统（参考）MCP服务器

提供支持可配置允许路径的本地文件系统访问。

什么是MCP服务器？

特性

可用工具（11个）

---

工具详情

工具：create_directory

创建新目录或确保目录存在。可在一次操作中创建多个嵌套目录。若目录已存在，操作将静默成功。适用于设置项目目录结构或确保所需路径存在。仅在允许的目录内工作。

---

工具：directory_tree

以JSON结构获取文件和目录的递归树形视图。每个条目包含'name'（名称）、'type'（类型：file/directory）和目录的'children'（子项）。文件无children数组，目录始终有children数组（可能为空）。输出采用2空格缩进格式以提高可读性。仅在允许的目录内工作。

---

工具：edit_file

对文本文件进行基于行的编辑。每次编辑用新内容替换精确的行序列。返回git风格的差异以显示所做更改。仅在允许的目录内工作。

---

工具：get_file_info

检索文件或目录的详细元数据。返回包括大小、创建时间、最后修改时间、权限和类型的综合信息。此工具适用于了解文件特性而无需读取实际内容。仅在允许的目录内工作。

---

工具：list_allowed_directories

返回本服务器允许访问的目录列表。使用此工具可在尝试访问文件前了解可用目录。

---

工具：list_directory

获取指定路径下所有文件和目录的详细列表。结果用[FILE]和[DIR]前缀明确区分文件和目录。此工具对于了解目录结构和查找目录内特定文件至关重要。仅在允许的目录内工作。

---

工具：move_file

移动或重命名文件和目录。可在一次操作中在目录间移动文件或重命名。若目标已存在，操作将失败。可跨不同目录工作，也可用于同一目录内的简单重命名。源和目标必须均在允许的目录内。

---

工具：read_file

从文件系统读取文件的完整内容。处理各种文本编码，若文件无法读取则提供详细错误消息。当需要检查单个文件内容时使用此工具。仅在允许的目录内工作。

---

工具：read_multiple_files

同时读取多个文件的内容。当需要分析或比较多个文件时，此工具比逐个读取更高效。每个文件的内容与其路径一起返回。单个文件读取失败不会终止整个操作。仅在允许的目录内工作。

---

工具：search_files

递归搜索匹配模式的文件和目录。从起始路径搜索所有子目录。搜索不区分大小写且匹配部分名称。返回所有匹配项的完整路径。适用于不知道文件确切位置时查找文件。仅在允许的目录内搜索。

---

工具：write_file

创建新文件或用新内容完全覆盖现有文件。使用时需谨慎，因为它会无警告地覆盖现有文件。以正确编码处理文本内容。仅在允许的目录内工作。

---

使用此MCP服务器

json
{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/local-directory:/local-directory",
        "mcp/filesystem",
        "/local-directory"
      ]
    }
  }
}

为什么使用Docker运行MCP服务器更安全？