Filesystem Operations MCP

🚀 批量文件系統操作 MCP 服務器

本項目推出了一個 FastMCP 服務器，它提供了用於執行批量文件和文件夾操作的工具，還具備集中式異常處理功能，能有效提升文件系統操作的效率和穩定性。

🚀 快速開始

VS Code McpServer 使用

1. 打開命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）。
2. 輸入 "Settings" 並選擇 "Preferences: Open User Settings"。
3. 將以下內容添加到用戶設置中：

{
    "git.path": "/path/to/git",
    "python.pythonPath": "/path/to/python"
}

Roo Code/Cline 中的 McpServer 使用

1. 在項目根目錄下創建一個 mcpserver.json 文件。
2. 將以下內容添加到文件中：

{
    "git.path": "/path/to/git",
    "python.pythonPath": "/path/to/python"
}

✨ 主要特性

該服務器提供的工具按功能可分為以下類別：

• call_tool_bulk：通過一次請求多次調用註冊在此 MCP 服務器上的單個工具，能顯著加快原本需多次單獨工具調用的操作。
• call_tools_bulk：在單次請求中調用註冊在此 MCP 服務器上的多個工具，每個調用可以是不同的工具，且可包含不同參數，同樣有助於加快原本需多次單獨調用的操作。

若要將批量工具添加到您的 FastMCP 服務器，請參見 相關鏈接。

文件操作工具 (file 服務器)

這些工具在 file 服務器命名空間下可用：

• read：讀取指定路徑文件的內容。
• create：創建包含指定內容的文件。
• append：向現有文件追加內容。
• erase：清空文件內容。
• move：將文件從源位置移動到目標位置。
• delete：刪除指定路徑下的文件。

文件夾操作工具 (folder 服務器)

這些工具在 folder 服務器命名空間下可用：

• create：在指定路徑創建文件夾。
• read_all：返回文件夾中所有文件的內容（可選遞歸），不過此操作可能會消耗較多資源！
• list：列出文件夾的內容（可選遞歸）。
• move：將文件夾從源位置移動到目標位置。
• delete：刪除指定路徑下的文件夾。
• empty：通過刪除所有內容來清空文件夾。

禁用工具

您可以通過設置 DISABLE_FILE_TOOLS 為要禁用的工具名稱數組來禁用特定的文件工具。例如，要禁用 file_read 工具，請將 DISABLE_FILE_TOOLS=["file_read"]。 您可以設置 DISABLE_FOLDER_TOOLS 為要禁用的文件夾工具名稱數組來禁用特定的文件夾工具。例如，要禁用 folder_create 工具，請將 DISABLE_FOLDER_TOOLS=["folder_create"]。 需要注意的是，批量工具當前無法禁用。

📦 安裝指南

要克隆倉庫，請運行以下命令：

git clone https://github.com/your-username/repository.git
cd repository
pip install -r requirements.txt
python app.py

克隆倉庫的替代方法

您可以使用 git+https 協議直接從倉庫獲取代碼。例如：

pip install -e git+https://github.com/your-username/repository.git#egg=package-name

通過這種方式，您可以通過指定分支名稱來克隆倉庫的不同版本，例如：

pip install -e git+https://github.com/your-username/repository.git@branch-name#egg=package-name