← 返回目录
F

Fast Filesystem MCP

社区
为Claude Desktop优化的高性能文件系统MCP服务器,支持大文件处理和先进编辑功能。
GitHub 源仓库 ↗
★ 59 Stars 分类 · 文件系统 热门 源版本 b265ee79a108
47FMRS · D
可靠性
7/20
安全与权限
8/20
维护活跃度
9/20
文档质量
11/20
安装易用性
12/20

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

查看 FMRS 评分方法 →

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

工具能力

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
删除文件或目录
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配置中添加以下内容:

  1. 打开Claude Desktop配置文件(claude_desktop_config.json)。
  2. mcpServers中添加fast-filesystem,使用npx -y fast-filesystem-mcp命令。
  3. 重新启动Claude Desktop。
  4. 可选:设置环境变量CREATE_BACKUP_FILES=true以启用备份文件创建。
claude_desktop_config.json
{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"]
    }
  }
}

选型与风险

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

常见排障

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

使用场景

在Claude Desktop中进行高效的文件读写和编辑
处理超过内存限制的大文件
批量文件操作和目录同步
代码搜索和替换
归档压缩和解压

支持客户端

Claude Desktop完整支持