Filesystem Operations MCP

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

本项目推出了一个 FastMCP 服务器，它提供了用于执行批量文件和文件夹操作的工具，还具备集中式异常处理功能，能有效提升文件系统操作的效率和稳定性。

🚀 快速开始

VS Code McpServer 使用

1. 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）。
2. 输入 "Settings" 并选择 "Preferences: Open User Settings"。
3. 将以下内容添加到用户设置中：

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

Roo Code/Cline 中的 McpServer 使用

1. 在项目根目录下创建一个 mcpserver.json 文件。
2. 将以下内容添加到文件中：

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

✨ 主要特性

该服务器提供的工具按功能可分为以下类别：

• call_tool_bulk：通过一次请求多次调用注册在此 MCP 服务器上的单个工具，能显著加快原本需多次单独工具调用的操作。
• call_tools_bulk：在单次请求中调用注册在此 MCP 服务器上的多个工具，每个调用可以是不同的工具，且可包含不同参数，同样有助于加快原本需多次单独调用的操作。

若要将批量工具添加到您的 FastMCP 服务器，请参见 相关链接。

文件操作工具 (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"]。 需要注意的是，批量工具当前无法禁用。

📦 安装指南

要克隆仓库，请运行以下命令：

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

克隆仓库的替代方法

您可以使用 git+https 协议直接从仓库获取代码。例如：

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

通过这种方式，您可以通过指定分支名称来克隆仓库的不同版本，例如：

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