File Operations MCP Server

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

Features

• Basic File Operations: Copy, read, write, move, and delete files
• Directory Operations: Create, remove, and copy directories
• File Watching: Monitor files and directories for changes
• Change Tracking: Track and query file operation history
• Streaming Support: Handle large files efficiently with streaming
• HTTP Interface: Streamable HTTP interface with Server-Sent Events (SSE)
• Resource Support: Access files and directories through MCP resources
• Progress Reporting: Real-time progress updates for long operations
• Rate Limiting: Protection against excessive requests
• Enhanced Security: Path validation and input sanitization
• Robust Error Handling: Comprehensive error handling and reporting
• Type Safety: Full TypeScript support with strict type checking
• Docker Support: Containerized deployment with volume mounting

Installation

Installing via Smithery

To install File Operations Server for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install

Docker Installation

See DOCKER.md for comprehensive Docker setup instructions including local drive mounting for Windows and Linux.

Quick Docker Start:

# Stdio transport (for MCP clients)
docker run -it --rm -v "$(pwd):/workspace" ghcr.io/bsmi021/mcp-file-operations-server

# HTTP transport (for web/remote access)
docker run -it --rm -p 3001:3001 -v "$(pwd):/workspace" -e MCP_TRANSPORT=http ghcr.io/bsmi021/mcp-file-operations-server

Usage

Transport Modes

The server supports two transport modes:

1. Stdio Transport (Default)

For direct integration with MCP clients like Claude Desktop:

npm start

2. HTTP Transport with SSE (New in v1.5)

For remote connections and web applications:

npm run start:http

The HTTP server provides:

• SSE Endpoint: GET http://localhost:3001/sse - Establishes streaming connection
• Messages Endpoint: POST http://localhost:3001/messages - Receives client messages
• Health Check: GET http://localhost:3001/health - Server status
• Sessions: GET http://localhost:3001/sessions - Active connection info

Starting the Server

Development Mode

# Stdio transport with auto-reload
npm run dev

# HTTP transport with auto-reload
npm run dev:http

Production Mode

# Stdio transport
npm start

# HTTP transport
npm run start:http

# Custom port for HTTP
npm run start:http -- --port 8080

Available Tools

Basic File Operations

• copy_file: Copy a file to a new location
• read_file: Read content from a file
• write_file: Write content to a file
• move_file: Move/rename a file
• delete_file: Delete a file
• append_file: Append content to a file

Directory Operations

• make_directory: Create a directory
• remove_directory: Remove a directory
• copy_directory: Copy a directory recursively (with progress reporting)

Watch Operations

• watch_directory: Start watching a directory for changes
• unwatch_directory: Stop watching a directory

Change Tracking

• get_changes: Get the list of recorded changes
• clear_changes: Clear all recorded changes

Available Resources

Static Resources

• `file:///recent-chang

... View full README on GitHub