File Operations MCP Server
2025.03.13
9
TypeScript文件管理文件操作文件监控变更跟踪文件管理
File Operations MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，提供增强的文件操作能力，包括流式处理、补丁和变更跟踪支持。该服务支持基本的文件操作（如复制、读取、写入、移动和删除文件）、目录操作（如创建、移除和复制目录）、文件监控、变更跟踪以及高效的流式处理大文件。此外，它还提供了资源支持、实时进度报告、速率限制、增强的安全性和健壮的错误处理。
View on GitHub
Overview
基本能力
产品定位
File Operations MCP Server 是一个专注于文件操作和管理的服务，提供高效、安全的文件处理能力。
核心功能
- 基本文件操作：复制、读取、写入、移动和删除文件
- 目录操作：创建、移除和复制目录
- 文件监控：监控文件和目录的变更
- 变更跟踪：跟踪和查询文件操作历史
- 流式支持：高效处理大文件
- 资源支持：通过 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 次操作
- 路径验证：所有文件路径都会验证以防止目录遍历攻击
- 错误处理：提供详细的错误信息，包括错误代码、消息和相关元数据
使用教程
使用依赖
无特殊前置依赖，直接安装即可。
安装教程
通过 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 lint
npm run format