MCP Many Files

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

本項目提供了一個快速 MCP 服務器，該服務器配備了用於執行批量文件和文件夾操作的工具。同時，它還具備集中式異常處理功能，可有效處理文件系統操作過程中出現的異常。

🚀 快速開始

VS Code McpServer 使用

1. 打開命令面板（Ctrl + Shift + P 或 Cmd + Shift + P）。
2. 輸入“Settings”，並選擇“Preferences: Open User Settings (JSON)”。
3. 添加以下 MCP Server 配置：

{
    "mcp": {
        "servers": {
            "Filesystem Operations": {
                "command": "uvx",
                "args": [
                    "https://github.com/strawgate/mcp-many-files.git"
                ]
            }
        }
    }
}

Roo Code / Cline McpServer 使用

只需在您的 McpServer 配置中添加以下內容：

{
  "development": true,
  "mcp": {
    "servers": {
      "Filesystem Operations": {
        "command": "uvx",
        "args": [
          "git+https://github.com/strawgate/filesystem-operations-mcp@main"
        ]
      }
    }
  }
}

✨ 主要特性

批量工具

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

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

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

文件夾操作工具 (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"]。
• 當前無法禁用批量工具。

📦 安裝指南

要運行此項目，您需要先安裝 Node.js 和 pnpm。然後按照以下步驟操作：

1. 克隆倉庫：

git clone git+https://github.com/strawgate/filesystem-operations-mcp.git
cd filesystem-operations-mcp

2. 安裝依賴項：

pnpm install

3. 運行項目：

pnpm run dev

🤝 貢獻

貢獻者請遵循Contributing Guide。

📄 許可證

此項目的授權信息請參見LICENSE文件。