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

📚 详细文档

若要向您的FastMCP服务器添加批量工具，请参见 https://github.com/jlowin/fastmcp/pull/215。

🤝 贡献

贡献者需遵循Contributing Guide。

📄 许可证

此项目的授权信息请参见LICENSE文件。