Fast Filesystem MCP

🚀 快速文件系統MCP

快速文件系統MCP為Claude Desktop提供高級文件系統操作，具備處理大文件的能力以及針對Claude優化的特性，能有效提升文件處理效率。

🚀 快速開始

將其添加到你的Claude Desktop配置中。

基礎設置

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

啟用備份文件

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

備份配置

控制備份文件的創建行為。

• CREATE_BACKUP_FILES=false（默認）：禁用備份文件創建，以減少文件冗餘。
• CREATE_BACKUP_FILES=true：在修改文件前創建備份文件。

⚠️ 重要提示

備份文件會帶有時間戳（例如，file.txt.backup.1755485284402），以防止在編輯過程中數據丟失。

🆕 新版本更新

要更新到最新版本，請按照以下步驟操作：

1. 卸載舊版本

   npm uninstall -g fast-filesystem-mcp
   

2. 清理緩存和依賴項

   npm cache clean --force
   pnpm store prune
   

3. 安裝最新版本

   npm install -g fast-filesystem-mcp
   

4. 驗證安裝

   npm list -g fast-filesystem-mcp
   fast-filesystem-mcp --version
   

✨ 主要特性

核心文件操作

• 快速文件讀寫：針對Claude Desktop進行優化，支持分塊讀寫。
• 順序讀取：支持使用延續令牌完整讀取大文件。
• 大文件處理：基於流的寫入方式，可處理任意大小的文件。
• 目錄操作：提供全面的目錄列表、創建和管理功能。
• 文件搜索：支持按文件名和內容進行文件搜索，並可進行過濾。

高級功能

• 分頁支持：高效處理大型目錄。
• 分塊讀取：以可管理的塊讀取大文件。
• 流式寫入：內存高效的大文件寫入方式。
• 備份與恢復：自動創建備份文件並支持錯誤恢復。
• 重試邏輯：內置重試機制，確保操作可靠。

性能優化

• Claude優化：響應大小和格式針對Claude進行了優化。
• 內存高效：流式操作防止內存溢出。
• 智能排除：自動排除系統文件和目錄。
• 進度跟蹤：即時監控大型操作的進度。

📦 可用工具

文件操作

複雜文件管理

歸檔管理

目錄同步

高級編輯工具

目錄操作

搜索操作

系統操作

💻 使用示例

精確文件編輯

快速文件系統MCP現在包含用於源代碼和文本文件的強大編輯工具。

fast_edit_file - 單塊編輯

支持多種編輯模式。

• replace：替換文本或整行。
• replace_range：一次性替換多行。
• insert_before：在指定行之前插入內容。
• insert_after：在指定行之後插入內容。
• delete_line：刪除特定行。

{
  "tool": "fast_edit_file",
  "arguments": {
    "path": "/path/to/file.js",
    "mode": "replace",
    "line_number": 10,
    "new_text": "const newVariable = 'updated value';",
    "backup": true
  }
}

fast_edit_multiple_blocks - 批量編輯

在一次操作中編輯文件的多個部分。

{
  "tool": "fast_edit_multiple_blocks", 
  "arguments": {
    "path": "/path/to/file.js",
    "edits": [
      {
        "mode": "replace",
        "old_text": "oldFunction()",
        "new_text": "newFunction()"
      },
      {
        "mode": "insert_after",
        "line_number": 5,
        "new_text": "// Added comment"
      }
    ],
    "backup": true
  }
}

fast_extract_lines - 行提取

按行號、範圍或模式提取特定行。

{
  "tool": "fast_extract_lines",
  "arguments": {
    "path": "/path/to/file.js",
    "pattern": "function.*",
    "context_lines": 2
  }
}

fast_search_and_replace - 高級替換

支持正則表達式的強大搜索和替換功能。

{
  "tool": "fast_search_and_replace",
  "arguments": {
    "path": "/path/to/file.js", 
    "search_pattern": "console\\.log\\(.*\\)",
    "replace_text": "logger.info($1)",
    "use_regex": true,
    "max_replacements": 10,
    "backup": true
  }
}

編輯特性

• 自動備份：在修改文件前創建備份。
• 錯誤恢復：失敗時從備份中恢復。
• 行級操作：精確控制特定行。
• 模式匹配：支持正則表達式。
• 批量操作：在單個事務中進行多次編輯。
• 上下文提取：提取帶有周圍上下文的行。

大文件寫入

• fast_large_write_file
  • 流式處理：分塊寫入文件，防止內存問題。
  • 備份：在覆蓋文件前自動創建備份。
  • 驗證：寫入後驗證文件完整性。
  • 重試邏輯：失敗時自動重試，採用指數退避策略。
  • 進度跟蹤：即時監控寫入進度。

📄 許可證

本項目採用Apache 2.0許可證。

版權所有 2025 efforthye

根據Apache許可證，版本2.0（“許可證”）許可；除非符合許可證，否則不得使用此文件。你可以在以下網址獲取許可證副本：

除非適用法律要求或書面同意，否則根據許可證分發的軟件按“原樣”分發，不附帶任何形式的明示或暗示保證。請參閱許可證以瞭解管理權限和限制的特定語言。

🔗 倉庫地址

https://github.com/efforthye/fast-filesystem-mcp