File Operations

by bsmi021

9 stars
31 downloads
Not rated
GitHub

About

Enhances file and directory management with streaming, patching, and change tracking for advanced manipulation, real-time monitoring, and integration into automated workflows.

Details

Author
bsmi021
Repository
bsmi021/mcp-file-operations-server
GitHub stars
9
Downloads
31
License
MIT License
Categories
Productivity, Developer Tools, Design, File Management, AI, Automation, Infrastructure, Frontend, Other
Tags
#integration

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name File Operations
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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

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

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

Quick Docker Start:


bash

| Variable | Default | Description |
|----------|---------|-------------|
| MCP_TRANSPORT | stdio | Transport mode: stdio or http |
| MCP_HTTP_PORT | 3001 | Port for HTTP transport |

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.

make_directory

Create a directory.

remove_directory

Remove a directory.

copy_directory

Copy a directory recursively (with progress reporting).

watch_directory

Start watching a directory for changes.

unwatch_directory

Stop watching a directory.

get_changes

Get the list of recorded changes.

clear_changes

Clear all recorded changes.

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "file operations": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

File Operations MCP Server

smithery badge

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

<a href="https://glama.ai/mcp/servers/7b750si00d">
File Operations Server MCP server
</a>

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:
```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.