🚀 批量文件系统操作 MCP 服务器
该项目提供了一个快速MCP服务器，可用于执行批量文件和文件夹操作。同时，它具备集中式异常处理功能，专门处理文件系统操作中出现的异常情况。
🚀 快速开始
VS Code McpServer 使用
- 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）。
- 输入“Settings”并选择“Preferences: Open User Settings (JSON)”。
- 添加以下MCP Server配置：
{
"mcp": {
"servers": {
"Filesystem Operations": {
"command": "uvx",
"args": [
"https://github.com/strawgate/mcp-many-files.git"
]
}
}
}
}
Roo Code / Cline McpServer 使用
只需在您的McpServer配置中添加以下内容：
{
"development": true,
"mcp": {
"servers": {
"Filesystem Operations": {
"command": "uvx",
"args": [
"git+https://github.com/strawgate/filesystem-operations-mcp@main"
]
}
}
}
}
✨ 主要特性
批量操作工具
call_tool_bulk：可多次调用注册在此MCP服务器上的单个工具，通过一次请求即可完成，能显著加快原本需要多次单独工具调用的操作。call_tools_bulk：能在一次请求中调用注册在此MCP服务器上的多个工具，每个调用可针对不同工具，还能包含不同参数，有效加快原本需要多次单独调用的过程。
文件操作工具 (file 服务器)
read：读取指定路径文件的内容。create：创建包含指定内容的文件。append：向现有文件追加内容。erase：清除文件内容。move：将文件从源移动到目标位置。delete：删除指定路径下的文件。
文件夹操作工具 (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"]。 - 当前无法禁用批量工具。
📦 安装指南
要运行此项目，您需要先安装Node.js和pnpm。然后按照以下步骤操作：
- 克隆仓库：
git clone git+https://github.com/strawgate/filesystem-operations-mcp.git
cd filesystem-operations-mcp
- 安装依赖项：
pnpm install
- 运行项目：
pnpm run dev
📚 详细文档
若要向您的FastMCP服务器添加批量工具，请参见 https://github.com/jlowin/fastmcp/pull/215。
🤝 贡献
贡献者需遵循Contributing Guide。
📄 许可证
此项目的授权信息请参见LICENSE文件。