MCP.so
Sign In
F

File Operation Mcp

@lxKylin

Repository

About File Operation Mcp

一个基于MCP的文件操作服务器，提供pdf拆分、合并、转图片、文件统计、文件压缩、文件解压、图片压缩等功能。

#file#file-operation

Config

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

{
  "mcpServers": {
    "file-operation-mcp": {
      "url": "http://localhost:3000/sse"
    }
  }
}

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 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.

Frequently asked questions

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.

Comments

Basic information

Category

Other

Transports

stdio

Author

lxKylin

Submitted by

Kylin

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Mobile Mcp

mobile-next

Model Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)

5.4K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K