What is Filesystem Operations Mcp

filesystem-operations-mcp is a FastMCP server designed for reading multiple files simultaneously, providing a tool to access the content of various files efficiently.

Use cases

Use cases include batch processing of log files, reading configuration files for applications, and extracting data from multiple documents for analysis.

How to use

To use filesystem-operations-mcp, add the specified configuration to your McpServer setup, including the command and arguments to point to the GitHub repository. Ensure to allow the ‘read_files’ command.

Key features

Key features include the ‘read_files’ tool for reading multiple file paths, progress reporting during file reading, and robust error handling for common issues like FileNotFoundError and PermissionError.

Where to use

filesystem-operations-mcp can be utilized in environments where bulk file reading is necessary, such as data processing applications, file management systems, and any scenario requiring efficient access to multiple files.

Bulk Filesystem Operations MCP Server

This project provides a FastMCP server that exposes tools for performing bulk file and folder operations. It includes centralized exception handling for filesystem operations.

Available Tools

The server provides the following tools, categorized by their functionality:

• call_tool_bulk: Call a single tool registered on this MCP server multiple times with a single request. Useful for speeding up what would otherwise take several individual tool calls.

• call_tools_bulk: Call multiple tools registered on this MCP server in a single request. Each call can be for a different tool and can include different arguments. Useful for speeding up what would otherwise take several individual tool calls.

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

File Operations Tools (file server)

These tools are available under the file server namespace.

• read: Reads the content of a file at the specified path
• create: Creates a file with the specified content
• append: Appends content to an existing file
• erase: Erases the content of a file
• move: Moves a file from source to destination
• delete: Deletes a file at the specified path

Folder Operations Tools (folder server)

These tools are available under the folder server namespace.

• create: Creates a folder at the specified path
• read_all: Returns the contents of all of the files in a folder (optionally, recursively). This can be expensive!
• list: Lists the contents of a folder (optionally, recursively)
• move: Moves a folder from source to destination
• delete: Deletes a folder at the specified path
• empty: Empties a folder by deleting all its contents

Disabling Tools

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

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

Bulk tools cannot currently be disabled.

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. Edit the AlwaysAllow list to include the tools you want to use without confirmation.

    "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"
      ]
    },

Development

1. Clone the repository:

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

2. Create a virtual environment and install dependencies:

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

3. Run the server locally for testing:

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

You can also debug with vscode via the built in debug launch configuration. To point your MCP Client to this local server, use the following MCP server configuration: