Filesystem Operations MCP

🚀 Bulk File System Operation MCP Server

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

🚀 Quick Start

Available Tools

The tools provided by this server are categorized by their functions as follows:

• call_tool_bulk: Call a single tool registered on this MCP server multiple times in one request. This is very 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 a single request. Each call can be a different tool and can include different parameters. This is very useful for speeding up operations that would otherwise require multiple individual 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 the specified path.
• create: Create a file containing the specified content.
• append: Append content to an existing file.
• erase: Empty the content of a file.
• move: Move a file from the source location to the target location.
• delete: Delete the file at the specified path.

Folder Operation Tools (folder Server)

These tools are available under the folder server namespace.

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

Disabling Tools

You can disable specific file tools by setting DISABLE_FILE_TOOLS to an array of the names of the tools to be disabled. 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 the names of the folder tools to be disabled. For example, to disable the folder_create tool, set DISABLE_FOLDER_TOOLS=["folder_create"].

Bulk tools cannot be disabled at present.

Using McpServer in VS Code

1. Open the command palette (Ctrl+Shift+P or Cmd+Shift+P).
2. Type "Settings" and select "Preferences: Open User Settings".
3. Add the following content to the user settings:

{
    "git.path": "/path/to/git",
    "python.pythonPath": "/path/to/python"
}

Using McpServer in Roo Code/Cline

1. Create a mcpserver.json file in the project root directory.
2. Add the following content to the file:

{
    "git.path": "/path/to/git",
    "python.pythonPath": "/path/to/python"
}

📦 Installation

To clone the repository, run the following commands:

git clone https://github.com/your-username/repository.git
cd repository
pip install -r requirements.txt
python app.py

Alternative Way to Clone the Repository

You can use the git+https protocol to directly obtain the code from the repository. For example:

pip install -e git+https://github.com/your-username/repository.git#egg=package-name

In this way, you can clone different versions of the repository by specifying the branch name. For example:

pip install -e git+https://github.com/your-username/repository.git@branch-name#egg=package-name