File Operations MCP Server

Name: File Operations MCP Server
Author: bsmi021

@bsmi021

About File Operations MCP Server

A Model Context Protocol (MCP) server that provides enhanced file operation capabilities with streaming, patching, and change tracking support.

Basic information

Config

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

{
  "mcpServers": {
    "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?

File Operations MCP Server is a Model Context Protocol (MCP) server that provides enhanced file operation capabilities with streaming, patching, and change tracking support. It is designed for developers who need to integrate file and directory operations into MCP clients like Claude Desktop or web applications.

How to use File Operations MCP Server?

Install via Smithery (npx -y @smithery/cli install @bsmi021/mcp-file-operations-server --client claude) or manually after cloning the repository. Start with npm start for stdio transport (default for MCP clients) or npm run start:http for HTTP transport with SSE. Tools include copy_file, read_file, write_file, move_file, delete_file, append_file, make_directory, remove_directory, copy_directory, watch_directory, unwatch_directory, get_changes, and clear_changes. Configure transport mode and HTTP port via environment variables MCP_TRANSPORT and MCP_HTTP_PORT.

Key features of File Operations MCP Server

Basic file and directory operations
File watching with recursive support
Change tracking with history querying
Streaming support for large files
HTTP interface with Server-Sent Events (SSE)
Docker support with volume mounting

Use cases of File Operations MCP Server

Automating file management tasks through conversational AI assistants
Monitoring directories for real‑time changes in development workflows
Streaming large files efficiently without memory overload
Providing remote file access via HTTP endpoints for web applications
Securely integrating file operations into multi‑session environments

FAQ from File Operations MCP Server

What transport modes does the server support?

It supports two modes: stdio transport for direct integration with MCP clients like Claude Desktop, and HTTP transport with SSE for remote connections and web applications.

How can I install the server?

Install it automatically via Smithery using npx -y @smithery/cli install, or manually by cloning the repository and running npm install.

Does the server support Docker?

Yes, it provides full Docker support. You can run it with docker run using either stdio or HTTP transport, and mount local directories as volumes for file access.

What are the rate limits for operations?

Rate limits are 100 requests per minute for tools, 200 for resources, and 20 for watch operations. Exceeding these returns an error with a retry-after period.

How does the server ensure security?

All file paths are validated to prevent directory traversal attacks, input is sanitized, rate limiting is enforced, and proper error handling and logging are implemented.