DeepSeek 导航网

Filesystem-MCP 服务器

🔥 热度：7

提供安全高效文件访问权限

DeepSeek 导航网：Filesystem-MCP 服务器为您的 AI 代理（如 Cline/Claude）提供安全、高效且节省令牌的项目文件访问权限。这个 Node.js 服务器实现了模型上下文协议 (MCP)，提供了一组强大的文件系统工具，并在定义的项目根目录内安全运行。

安装

有几种方法可以使用文件系统 MCP 服务器：

1. 推荐：通过 MCP 主机配置使用 npx（或 bunx）

最简单的方法是通过 npx 或 bunx，直接在您的 MCP 主机环境（例如 Roo/Cline 的 mcp_settings.json）中进行配置。这确保您始终使用 npm 上的最新版本，而无需本地安装或 Docker 。

示例 (npx)：

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "npx",
      "args": ["@sylphlab/filesystem-mcp"],
      "name": "Filesystem (npx)"
    }
  }
}

示例 (bunx)：

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "bunx",
      "args": ["@sylphlab/filesystem-mcp"],
      "name": "Filesystem (bunx)"
    }
  }
}

重要提示： 服务器使用其自己的当前工作目录 (cwd) 作为项目根目录。请确保您的 MCP 主机（例如 Cline/VSCode）配置为以您的活动项目的根目录作为 cwd 启动命令。

2. Docker

对于容器化环境，请使用官方 Docker 镜像。

MCP 主机配置示例：

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/path/to/your/project:/app", // Mount your project to /app
        "sylphlab/filesystem-mcp:latest"
      ],
      "name": "Filesystem (Docker)"
    }
  }
}

请记得将 /path/to/your/project 替换为正确的绝对路径。

3. 本地构建（用于开发）

克隆：git clone https://github.com/sylphlab/filesystem-mcp.git
安装：cd filesystem-mcp && pnpm install （现在使用 pnpm）
构建：pnpm run build

配置 MCP 主机：

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "node",
      "args": ["/path/to/cloned/repo/filesystem-mcp/dist/index.js"], // 更新后的构建目录
      "name": "Filesystem (本地构建)"
    }
  }
}

注意： 从您希望作为项目根目录的目录启动 node 命令。

快速开始

一旦在您的 MCP 主机中配置了服务器（参见安装部分），您的 AI 代理就可以立即开始使用文件系统工具。

示例代理交互（概念性）：

Agent: <use_mcp_tool>
         <server_name>filesystem-mcp</server_name>
         <tool_name>read_content</tool_name>
         <arguments>{"paths": ["src/index.ts"]}</arguments>
       </use_mcp_tool>

Server Response: (Content of src/index.ts)

为什么选择这个项目？

🛡️ 安全且便捷的项目根目录聚焦: 操作仅限于项目根目录（启动时的 cwd）。
⚡ 优化与整合的工具: 批量操作减少了 AI 服务器往返次数，节省了令牌和延迟。每个批次中的每个项目都有可靠的结果。
🚀 易于集成: 通过 npx/bunx 快速设置。
🐳 容器化选项: 可作为 Docker 镜像使用。
🔧 全面的功能: 涵盖广泛的文件系统任务。
✅ 强大的验证: 使用 Zod 模式进行参数验证。

性能优势

(占位符：在此处添加基准测试结果和比较，展示相对于其他方法如单个 shell 命令的优势。)

批量操作: 与单一操作相比显著减少了开销。
直接 API 使用: 比为每个命令生成 shell 进程更高效。
(在有具体基准数据时添加)

功能

该服务器为您的 AI 代理配备了强大而高效的文件系统工具包：

📁 浏览与检查 (list_files, stat_items): 列出文件/目录（递归、统计），获取多个项目的详细状态。
📄 读取与写入内容 (read_content, write_content): 读取/写入/追加多个文件，创建父目录。
✏️ 精确编辑与搜索 (edit_file, search_files, replace_content): 在多个文件中执行外科手术式的编辑（插入、替换、删除），保留缩进并输出差异；带上下文的正则表达式搜索；多文件搜索/替换。
🏗️ 管理目录 (create_directories): 创建多个目录包括中间的父目录。
🗑️ 安全删除 (delete_items): 递归删除多个文件/目录。
↔️ 移动与复制 (move_items, copy_items): 移动/重命名/复制多个文件/目录。
🔒 控制权限 (chmod_items, chown_items): 更改多个项目的 POSIX 权限和所有权。

主要优势: 所有接受多个路径/操作的工具都单独处理每个项目，并返回详细的状况报告。

设计理念

(占位符：解释核心设计原则。)

安全第一: 优先防止访问项目根目录之外的内容。
效率: 最小化 AI 交互的通信开销和令牌使用。
健壮性: 为批量操作提供详细的成果和错误报告。
简洁性: 通过 MCP 提供清晰一致的 API 。
标准合规性: 严格遵守模型上下文协议。

安装

快速开始

为什么选择这个项目？

性能优势

功能

设计理念

相关推荐