MCP Filesystem Server

🚀 文件系統 MCP 服務器

本項目是一個用 Go 語言實現的模型上下文協議（MCP）文件系統操作服務器，可實現文件與目錄的讀取、寫入、創建、刪除、移動、搜索等操作，還能獲取文件元數據和生成目錄樹結構。

🚀 快速開始

安裝服務器

go install github.com/mark3labs/mcp-filesystem-server

配置 claude_desktop_config.json

在 claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": [
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

✨ 主要特性

• 🔍 支持文件的讀取與寫入操作。
• 📁 可進行目錄的創建、列出和刪除。
• 🚚 能夠移動文件和目錄，也可對其重命名。
• 🔎 支持遞歸搜索文件和目錄。
• ℹ️ 可以獲取文件的詳細元數據。
• 🌳 能生成目錄樹的層次化 JSON 表示。

⚠️ 重要提示

該服務器僅允許在 args 中指定的目錄內執行操作。

📚 詳細文檔

🔍 資源

• file://system：文件系統操作接口

🛠️ 工具

• read_file

  • 功能：讀取文件的全部內容。
  • 輸入：path（字符串）
  • 說明：使用 UTF-8 編碼讀取完整的文件內容。

• read_multiple_files

  • 功能：同時讀取多個文件。
  • 輸入：paths（字符串數組）
  • 說明：失敗的讀取不會停止整個操作。

• write_file

  • 功能：創建新文件或覆蓋現有文件（謹慎使用此功能）。
  • 輸入：
    • path（字符串）：文件路徑
    • content（字符串）：文件內容

• create_directory

  • 功能：創建新目錄或確保其存在。
  • 輸入：path（字符串）
  • 說明：如果需要，會創建父目錄；如果目錄已存在，則會靜默成功。

• list_directory

  • 功能：列出目錄內容，帶有 [FILE] 或 [DIR] 前綴。
  • 輸入：path（字符串）

• move_file

  • 功能：移動或重命名文件和目錄。
  • 輸入：
    • source（字符串）
    • destination（字符串）
  • 說明：如果目標已存在，則會失敗。

• search_files

  • 功能：遞歸搜索文件/目錄。
  • 輸入：
    • path（字符串）：起始目錄
    • pattern（字符串）：搜索模式
  • 說明：不區分大小寫的匹配，返回完整路徑的匹配項。

• get_file_info

  • 功能：獲取文件/目錄的詳細元數據。
  • 輸入：path（字符串）
  • 返回：
    • 大小
    • 創建時間
    • 修改時間
    • 訪問時間
    • 類型（文件/目錄）
    • 權限

• tree

  • 功能：返回目錄結構的層次化 JSON 表示。
  • 輸入：
    • path（字符串）：要遍歷的目錄（必需）
    • depth（數字）：要遍歷的最大深度（默認值：3）
    • follow_symlinks（布爾值）：是否要跟隨符號鏈接（默認值：false）
  • 說明：返回格式化的 JSON，顯示文件/目錄層次結構，包含文件元數據（名稱、路徑、大小、修改時間）。

• list_allowed_directories

  • 功能：列出服務器可以訪問的所有目錄。
  • 輸入：無
  • 返回：該服務器可以讀取和寫入的目錄

📄 許可證

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