File Operations MCP Server

基本能力

产品定位

File Operations MCP Server 是一个提供高效、安全文件操作服务的 MCP 服务器，支持流式处理、变更跟踪和资源访问。

核心功能

• 基本文件操作：复制、读取、写入、移动和删除文件
• 目录操作：创建、移除和复制目录
• 文件监控：监控文件和目录的变更
• 变更跟踪：跟踪和查询文件操作历史
• 流式支持：高效处理大文件
• 资源支持：通过 MCP 资源访问文件和目录
• 进度报告：实时更新长时间操作的进度
• 速率限制：防止过多请求
• 增强安全性：路径验证和输入清理
• 健壮的错误处理：全面的错误处理和报告
• 类型安全：完整的 TypeScript 支持

适用场景

• 需要高效处理大量文件的场景
• 需要监控文件变更的场景
• 需要安全进行文件操作的场景
• 需要跟踪文件操作历史的场景

工具列表

基本文件操作

• copy_file: 复制文件到新位置
• read_file: 从文件读取内容
• write_file: 写入内容到文件
• move_file: 移动/重命名文件
• delete_file: 删除文件
• append_file: 追加内容到文件

目录操作

• make_directory: 创建目录
• remove_directory: 移除目录
• copy_directory: 递归复制目录（带进度报告）

监控操作

• watch_directory: 开始监控目录变更
• unwatch_directory: 停止监控目录

变更跟踪

• get_changes: 获取记录的变更列表
• clear_changes: 清除所有记录的变更

常见问题解答

• 速率限制：工具每分钟 100 次请求，资源每分钟 200 次请求，监控操作每分钟 20 次。
• 路径验证：所有文件路径都会验证以防止目录遍历攻击。
• 错误处理：提供详细的错误信息，包括错误代码、消息和相关元数据。

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @bsmi021/mcp-file-operations-server --client claude

手动安装

npm install

调试方式

启动服务器

npm start

开发模式（自动重载）

npm run dev

构建

npm run build

测试

npm test

代码格式化

npm run format

代码检查

npm run lint

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。