File Operations MCP Server

What is File Operations MCP Server?

A Model Context Protocol (MCP) server that provides enhanced file operation capabilities with streaming, patching, and change tracking support. It integrates with MCP clients like Claude Desktop to enable programmatic file system management.

How to use File Operations MCP Server?

Install via Smithery (npx -y @smithery/cli install @bsmi021/mcp-file-operations-server --client claude) or manually with npm install. Start the server with npm start (development: npm run dev). Use tools like copy_file, read_file, write_file, move_file, delete_file, make_directory, remove_directory, copy_directory, watch_directory/unwatch_directory, and get_changes/clear_changes. Access files via resources at file://{path}, metadata://{path}, and directory://{path}.

Key features of File Operations MCP Server

• Basic file operations: copy, read, write, move, delete
• Directory operations: create, remove, copy recursively
• File watching with change tracking and history querying
• Streaming support for efficient large file handling
• Progress reporting for long-running operations
• Rate limiting and security path validation

Use cases of File Operations MCP Server

• Automate file operations within AI assistant workflows
• Monitor directories for real-time file changes
• Copy large directories with progress tracking
• Access file contents and metadata via MCP resources

FAQ from File Operations MCP Server

What are the rate limits?

Tools are limited to 100 requests per minute, resources to 200 requests per minute, and watch operations to 20 operations per minute.

How does the server ensure security?

All file paths are validated to prevent directory traversal attacks, including no parent directory references and proper path normalization.

What are the runtime requirements?

It requires Node.js and npm for installation and execution, with full TypeScript support.

How does progress reporting work?

Long-running operations like directory copying return a progress token with percentage updates, which can be used to track progress.

What error handling is provided?

Detailed errors are provided through the FileOperationError class and standard MCP error codes like InvalidRequest, InvalidParams, and InternalError.