← 返回目录

Fast Filesystem MCP

社区

为Claude Desktop优化的高性能文件系统MCP服务器，支持大文件处理和先进编辑功能。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 文件系统第 18 / 24
Stars: ★ 64 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 5 个月前
工具数: 26

47FMRS · D

该服务器提供了全面的文件系统功能，特别适合Claude Desktop用户处理大文件和复杂编辑。性能优化和备份机制是其亮点。由于是非官方服务器，建议在信任环境中使用，并注意权限控制。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

8/20

维护活跃度

9/20

文档质量

11/20

安装易用性

12/20

查看各项评分依据

可靠性 7/20: 仅依据静态源代码审查，无法验证实际执行。存在可能影响可靠性的风险点：例如在JSON响应中直接包含stderr输出（可能导致JSON解析错误）、依赖外部命令如'du'和'find'，以及某些工具对错误处理不完善。存在测试目录，但未发现覆盖关键路径的全面测试。因此上限为12，评分为7。
安全与权限 8/20: 未发现严重红线问题，如凭据窃取或恶意行为。该服务器支持运行任意shell命令（包括rm -rf等），但具有明确确认和工具级保护，实为重大风险。缺少通过TTY进行交互式确认的机制。可能导致拒绝服务（如读取整个根目录）或跨会话敏感数据泄露（启用备份时）。评分8反映已识别风险但未达高确定性。
维护活跃度 9/20: 仓库显示活跃：多次提交、版本标签和近期发布。存在未解决的issue，但响应可见。许可证为Apache-2.0，清晰。未见安全响应渠道。依赖通过package-lock.json等锁定。总体维护良好，但因缺少安全公告和发布说明减分。
文档质量 11/20: README广泛，涵盖安装、配置、环境变量，并提供每个工具的示例和参数。然而，文档内容自相矛盾：列出了'fast_search_and_replace'工具，但源代码中并未实现；且缺少错误处理和限制的说明。工具描述不完整，部分高级功能文档化但缺乏深入指南。因此评分11。
安装易用性 12/20: 安装路径为'npx fast-filesystem-mcp'，但README后续提到'npm install -g'，存在流程冗余。未提供Windows提示，但提供了配置示例（用于Claude Desktop）。服务器是纯Node.js，可通过多种方式启动，包括CLI和stdio。编码简单，整体设置仅需少量步骤。未提供预构建包。评分为12，因静态审查无法验证执行。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要快速文件操作的Claude Desktop用户
处理大文件或流式数据的开发者
需要备份和容错的文件编辑场景
自动化文件管理和同步任务

不适合谁

对安全性要求极高且不信任第三方MCP服务器的环境
需要网络传输（如SSE或HTTP）的远程场景
完全离线且无Node.js环境
需要图形界面或交互式文件管理

所需权限

读写文件系统：可以读取、写入、修改、删除文件和目录
创建备份文件（如果启用）
执行命令：通过`npx`运行包
访问网络（如果用于安装）

风险与副作用

文件操作可能导致数据丢失或覆盖，尽管有备份机制
恶意提示可能诱导误操作，需要用户确认
第三方服务器可能包含漏洞
允许的目录配置不当可能暴露敏感文件

安装接入

准备工作

运行环境：Node.js

其他可选配置项（6 个）

CREATE_BACKUP_FILES 可选设为 true 可在修改文件前创建带时间戳的备份文件；默认 false。见 README 备份配置章节。

DEBUG_MCP 可选设为 true 启用 stderr 调试日志；可选，无需获取。

MCP_DEBUG 可选与 DEBUG_MCP 等效，设为 true 启用调试日志；可选。

MCP_LOG_FILE 可选指定日志文件路径（如 /path/to/log.txt），日志将写入文件而非 stderr；可选。

MCP_SILENT_ERRORS 可选设为 true 可在响应中抑制错误消息；可选。

SILENT_ERRORS 可选与 MCP_SILENT_ERRORS 等效，设为 true 抑制错误消息；可选。

在Claude Desktop配置中添加以下内容：

打开Claude Desktop配置文件（claude_desktop_config.json）。
在mcpServers中添加fast-filesystem，使用npx -y fast-filesystem-mcp命令。
重新启动Claude Desktop。
可选：设置环境变量CREATE_BACKUP_FILES=true以启用备份文件创建。

claude_desktop_config.json

{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "fast-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "fast-filesystem-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add fast-filesystem -- npx -y fast-filesystem-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 工具列表中确认出现 fast_list_allowed_directories 等工具，然后询问"列出允许访问的目录"，若返回目录列表即说明安装成功。

常见排障

如果工具调用失败，检查`DEBUG_MCP=true`或`MCP_LOG_FILE`启用日志
确保文件路径在允许的目录内，可使用`fast_list_allowed_directories`查看
对于大文件，确保使用流式写入工具避免内存溢出
如果遇到JSON解析错误，禁用调试输出（默认已禁用）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的项目目录并显示目录树结构。
在 /path/to/file.js 中把所有 console.log 替换为 logger.info。
用正则搜索代码库中所有匹配 function.* 的行并提取上下文。
把这个目录压缩成 tar.gz 归档文件。

工具能力 26

fast_read_file 只读

分块读取文件

fast_read_multiple_files 只读

同时读取多个文件，支持顺序读取

fast_write_file 写入

写入或修改文件

fast_large_write_file 写入

基于流的大文件写入

fast_get_file_info 只读

获取详细信息

fast_copy_file 写入

复制文件或目录

fast_move_file 写入

移动或重命名文件或目录

fast_delete_file 破坏性

删除文件或目录

展开其余 18 个工具

fast_batch_file_operations 写入

按顺序执行多个文件操作

fast_compress_files 写入

创建压缩归档（tar、tar.gz、tar.bz2）

fast_extract_archive 写入

解压归档文件

fast_sync_directories 写入

高级目录同步，支持多种模式

fast_edit_file 写入

精确的基于行的文件编辑，支持多种模式

fast_edit_block 写入

使用精确字符串匹配进行安全块编辑

fast_edit_blocks 写入

批量块编辑

fast_edit_multiple_blocks 写入

单次操作编辑多个部分

fast_extract_lines 只读

按行号、范围或模式提取特定行

fast_search_and_replace 写入

支持正则的搜索替换

fast_list_directory 只读

列出目录内容，支持分页

fast_create_directory 写入

递归创建目录

fast_get_directory_tree 只读

获取目录树结构

fast_search_files 只读

按名称或内容搜索文件

fast_search_code 只读

结合ripgrep的高级代码搜索

fast_find_large_files 只读

查找目录中的大文件

fast_get_disk_usage 只读

检查磁盘使用情况

fast_list_allowed_directories 只读

列出允许访问的目录

使用场景

在Claude Desktop中进行高效的文件读写和编辑

处理超过内存限制的大文件

批量文件操作和目录同步

代码搜索和替换

归档压缩和解压

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Fast Filesystem MCP是一个基于Node.js和TypeScript构建的高性能MCP服务器，专为Claude和其他AI助手提供安全、高效的文件系统访问。它支持流式读写大文件、分块读取、目录同步、归档压缩、批量编辑等高级功能，并内置备份、重试逻辑和智能排除系统文件等特性。该服务器通过stdio传输，使用npx即可快速集成到Claude Desktop中。