File Operation Mcp

What is File Operation Mcp?

File Operation Mcp is an MCP (Model Context Protocol) server that provides file operations such as file counting, listing, image compression, archive creation/extraction, file copy/move, and PDF processing (merge, split, to image). It is built with Node.js and TypeScript and is intended for users who need to perform these tasks via an MCP-compatible client like Claude Desktop or Cursor IDE.

How to use File Operation Mcp?

Install Node.js ≥ 18.0.0, clone the repository, run pnpm install, then pnpm start. Choose between Stdio (IPC, local single-user) or SSE (HTTP, remote/multi-user) transport and configure the server in your MCP client (Claude Desktop or Cursor IDE) using the provided JSON snippets. The server exposes commands like count-files, list-files, compress-image, create-archive, extract-archive, copy-files, move-files, merge-pdf, split-pdf, and pdf-to-image, each with specific parameters.

Key features of File Operation Mcp

• File statistics and listing with hidden file option
• Image compression with quality, width, height control
• Archive creation (ZIP, TAR, TAR.GZ) with compression level
• Archive extraction for ZIP, TAR, TAR.GZ with overwrite option
• File and folder copy and move with timestamp preservation
• PDF merge, split (by page or range), and conversion to JPEG/PNG

Use cases of File Operation Mcp

• Count files on the desktop or a specified folder
• Compress images before uploading or sharing
• Create ZIP/TAR archives of project folders for backup
• Merge multiple PDF reports into one document
• Extract archives from downloads to a target directory

FAQ from File Operation Mcp

What are the system requirements?

Node.js version 18.0.0 or higher and pnpm (or npm) are required.

How do I configure the server for Claude Desktop?

For Stdio, add a JSON entry with command: "tsx", args: ["path/to/src/index.ts"], and cwd: "path/to/project". For SSE, use url: "http://localhost:3000/sse" after starting the HTTP server.

What image and archive formats are supported?

Image: JPEG, PNG, WebP, TIFF, GIF. Archive: ZIP, TAR, TAR.GZ (both create and extract).

How do I handle permission errors?

Ensure the Node.js process has read/write permissions for the target folders and files. Use absolute paths and check that the output directory is writable.

Can I run this server remotely?

Yes, by using the SSE transport mode. Start the HTTP server (default port 3000) and connect from a remote MCP client via its URL.