Filesystem MCP Server I1w

🚀 文件系統 MCP 服務器

本項目是一個基於 Node.js 實現的模型上下文協議（MCP）服務器，專門用於文件系統操作。它提供了豐富的文件和目錄管理功能，能滿足多樣化的文件系統操作需求。

🚀 快速開始

在 claudia.json 文件中添加以下內容，即可在 Claude Desktop 中使用該服務器：

{
  "filesystem": {
    "server": "mcp/filesystem",
    "options": {
      "sandboxed_directories": [
        "/path/to/sandbox1",
        "/path/to/sandbox2"
      ]
    }
  }
}

使用以下命令構建 Docker 鏡像：

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

✨ 主要特性

• 支持讀取/寫入文件，滿足基本的文件數據交互需求。
• 可進行創建/列出/刪除目錄操作，靈活管理文件系統的目錄結構。
• 能夠移動文件/目錄，方便進行文件位置的調整。
• 具備搜索文件功能，便於快速定位所需文件。
• 可以獲取文件元數據，瞭解文件的詳細信息。

⚠️ 重要提示

該服務器僅允許在通過 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）
  • 輸出：修改後的文件內容

• create_directory

  • 功能：創建新目錄。
  • 輸入：path（字符串）

• remove_directory

  • 功能：刪除目錄。
  • 輸入：path（字符串）

• list_directories

  • 功能：列出所有子目錄。
  • 輸入：path（字符串）
  • 輸出：包含子目錄路徑的數組

• rename_file

  • 功能：重命名文件。
  • 輸入：
    • oldPath（字符串）：舊文件路徑
    • newPath（字符串）：新文件路徑

• delete_file

  • 功能：刪除文件。
  • 輸入：path（字符串）

📄 許可證

該 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由地使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目倉庫中的 LICENSE 文件。