MCP Many Files

！！此项目已归档，请访问 https://github.com/strawgate/py-mcp-collection/tree/main/filesystem-operations-mcp 查看最新版本。

批量文件系统操作MCP服务器

该项目提供了一个FastMCP服务器，该服务器提供了用于执行批量文件和文件夹操作的工具。它还包括对文件系统操作的集中异常处理。

可用工具

服务器提供了以下工具，按功能分类如下：

• call_tool_bulk在一个MCP服务器上，通过单次请求多次调用已注册的单个工具。这有助于加快原本需要多次单独工具调用的过程。

• call_tools_bulk在一个请求中调用此MCP服务器上注册的多个工具。每次调用可以针对不同的工具，并且可以包含不同的参数。这有助于加快原本需要多次单独工具调用才能完成的操作。

要在您的FastMCP服务器上添加批量工具，请参阅 https://github.com/jlowin/fastmcp/pull/215

文件操作工具（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"].

批量工具目前无法禁用。

VS Code 中的 McpServer 使用方法

1. 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）。
2. 输入“设置”并选择“首选项：打开用户设置（JSON）”。
3. 添加以下MCP服务器配置

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

Roo代码/Cline Mcp服务器使用

只需在您的McpServer配置中添加以下内容。编辑AlwaysAllow列表，以包含您希望无需确认即可使用的工具。

    "Filesystem Operations": {
      "command": "uvx",
      "args": [
        "https://github.com/strawgate/mcp-many-files.git"
      ],
      "alwaysAllow": [
        "file_read",
        "file_create",
        "file_append",
        "file_erase",
        "file_move",
        "file_delete",
        "folder_create",
        "folder_contents",
        "folder_move",
        "folder_delete",
        "folder_empty",
        "call_tool_bulk",
        "call_tools_bulk"
      ]
    },

发展

1. 克隆仓库：

   # Replace with the actual repository URL
   git clone https://github.com/strawgate/filesystem-operations-mcp.git
   cd filesystem-operations-mcp

1. 创建一个虚拟环境并安装依赖项：

   uv venv
   source .venv/bin/activate
   uv sync --extra dev

1. 在本地运行服务器进行测试：

   python -m filesystem-operations-mcp.server
   # or using the installed script
   filesystem-operations-mcp

你也可以通过VSCode内置的调试启动配置来进行调试。要将你的MCP客户端指向这个本地服务器，请使用以下MCP服务器配置：

"filesystem_operations_mcp": {
  "url": "http://localhost:8000/sse",
  "disabled": true,
  "autoApprove": [],
  "timeout": 30,
  "alwaysAllow": []
}

You can also set your uvx command to point to a branch on the repository via `"git+https://github.com/strawgate/filesystem-operations-mcp@branch-name"`.