Filesystem Operations Mcp

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
  • 0 关注
  • 0 收藏,8 浏览
  • system 提出于 2025-09-29 11:27

相似服务问题

相关AI产品