File Operations MCP Server

Name: File Operations MCP Server
Author: MCP-Mirror

@MCP-Mirror

Repository

About File Operations MCP Server

Mirror of

#file-operations #mcp-server #file-management

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bsmi021_mcp-file-operations-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@bsmi021/mcp-file-operations-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.