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