MCP Many Files

🚀 Bulk File System Operations MCP Server

This project offers a Fast MCP server equipped with tools for executing bulk file and folder operations. It also features centralized exception handling for file system operations.

🚀 Quick Start

✨ Features

This server provides the following tools, categorized by their functions:

• call_tool_bulk: Invoke a single tool registered on this MCP server multiple times in one request. This is useful for speeding up operations that would otherwise require multiple individual tool calls.
• call_tools_bulk: Call multiple tools registered on this MCP server in one request. Each call can target a different tool and include different parameters. This is useful for accelerating processes that would otherwise require multiple separate calls.

To add bulk tools to your FastMCP server, refer to https://github.com/jlowin/fastmcp/pull/215.

File Operation Tools (file Server)

These tools are available under the file server namespace:

• read: Read the content of a file at a specified path.
• create: Create a file with specified content.
• append: Append content to an existing file.
• erase: Clear the content of a file.
• move: Move a file from a source to a target location.
• delete: Delete a file at a specified path.

Folder Operation Tools (folder Server)

These tools are available under the folder server namespace:

• create: Create a folder at a specified path.
• read_all: Return the content of all files in a folder (recursively, optionally). This can be very time-consuming!
• list: List the contents of a folder (recursively, optionally).
• move: Move a folder from a source to a target location.
• delete: Delete a folder at a specified path.
• empty: Empty a folder by deleting all its contents.

Disabling Tools

You can disable specific file tools by setting DISABLE_FILE_TOOLS to an array of tool names to disable. For example, to disable the file_read tool, set DISABLE_FILE_TOOLS=["file_read"].

You can disable specific folder tools by setting DISABLE_FOLDER_TOOLS to an array of tool names to disable. For example, to disable the folder_create tool, set DISABLE_FOLDER_TOOLS=["folder_create"].

Currently, bulk tools cannot be disabled.

💻 Usage Examples

VS Code McpServer Usage

1. Open the command palette (Ctrl+Shift+P or Cmd+Shift+P).
2. Type "Settings" and select "Preferences: Open User Settings (JSON)".
3. Add the following MCP Server configuration:

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

Roo Code / Cline McpServer Usage

Simply add the following to your McpServer configuration:

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

📦 Installation

To run this project, you need to install Node.js and pnpm first. Then follow these steps:

1. Clone the repository:

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

2. Install dependencies:

pnpm install

3. Run the project:

pnpm run dev

🤝 Contribution

Contributors should follow the Contributing Guide.

📄 License

Refer to the LICENSE file for licensing information about this project.