HelloWorld
登录
文

文件系统

实现用于文件系统操作的模型上下文协议（MCP）的 Node.js 服务器。

file-systems

6.9w 查看 · 2026-07-07 更新

简介

实现用于文件系统操作的模型上下文协议（MCP）的 Node.js 服务器。

简介

实现用于文件系统操作的模型上下文协议（MCP）的 Node.js 服务器。

文件系统 MCP 服务器

Node.js 服务器实现了用于文件系统操作的模型上下文协议 (MCP)。

特性

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

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

API

资源

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

工具

  • read_file

    • 读取文件的全部内容
    • 输入: path (字符串)
    • 使用 UTF-8 编码读取整个文件的内容

  • read_multiple_files

    • 同时读取多个文件
    • 输入: paths (字符串数组)
    • 失败的读取不会停止整个操作

  • write_file

    • 创建新文件或覆盖现有文件（使用时需谨慎）
    • 输入:
      • path (字符串): 文件位置
      • content (字符串): 文件内容

  • edit_file

    • 使用高级模式匹配和格式化进行选择性编辑
    • 功能:
      • 基于行和多行内容匹配
      • 保留缩进的空白字符规范化
      • 带置信度评分的模糊匹配
      • 正确定位的多个同时编辑
      • 缩进样式检测和保留
      • 带上下文的 Git 风格差异输出
      • 干运行模式预览更改
      • 带置信度评分的失败匹配调试
    • 输入:
      • path (字符串): 要编辑的文件
      • edits (数组): 编辑操作列表
        • oldText (字符串): 要搜索的文本（可以是子字符串）
        • newText (字符串): 要替换为的文本
      • dryRun (布尔值): 不应用更改的情况下预览更改 (默认: false)
      • options (对象): 可选的格式设置
        • preserveIndentation (布尔值): 保持现有的缩进 (默认: true)
        • normalizeWhitespace (布尔值): 在保留结构的同时规范化空格 (默认: true)
        • partialMatch (布尔值): 启用模糊匹配 (默认: true)
    • 返回详细的差异和匹配信息（干运行模式），否则应用更改
    • 最佳实践：在应用更改之前，始终先使用干运行模式预览更改

  • create_directory

    • 创建新目录或确保其存在
    • 输入: path (字符串)
    • 如果需要，创建父目录
    • 如果目录已存在，则静默成功

  • list_directory

    • 列出带有 [FILE] 或 [DIR] 前缀的目录内容
    • 输入: path (字符串)

  • move_file

    • 移动或重命名文件和目录
    • 输入:
      • source (字符串)
      • destination (字符串)
    • 如果目标已存在则失败

  • search_files

    • 递归搜索文件/目录
    • 输入:
      • path (字符串): 起始目录
      • pattern (字符串): 搜索模式
      • excludePatterns (字符串数组): 排除任何模式。支持 Glob 格式。
    • 匹配不区分大小写
    • 返回匹配项的完整路径

  • get_file_info

    • 获取详细的文件/目录元数据
    • 输入: path (字符串)
    • 返回:
      • 大小
      • 创建时间
      • 修改时间
      • 访问时间
      • 类型 (文件/目录)
      • 权限

  • list_allowed_directories

    • 列出服务器允许访问的所有目录
    • 无需输入
    • 返回:
      • 该服务器可以从中读取/写入的目录

与 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"
      ]
    }
  }
}

构建

Docker 构建：

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

许可证

此 MCP 服务器根据 MIT 许可证授权。这意味着你可以在遵守 MIT 许可证条款和条件的前提下自由使用、修改和分发该软件。更多详情，请参见项目仓库中的 LICENSE 文件。

服务配置

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

来源