About File Converter MCP Server
File Ops is a local file operations skill for AI agents, built around a bundled Python script. It converts, inspects, archives and extracts text from files, returning structured JSON output.
Key features
- 01Image and document format conversion
- 02Metadata inspection for files, images, PDF and Excel
- 03Zip creation and extraction with ZipSlip protection
- 04Text extraction from PDF, DOCX, XLSX, HTML and Markdown
- 05Image EXIF metadata extraction
Use cases
- 01Converting PDF files to DOCX or Excel sheets to CSV
- 02Checking local file size, type or page count before processing
- 03Archiving or extracting local directories for delivery
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEFile Ops
简体中文 | English
A local file operations skill for AI agents. Convert, inspect, archive, and extract text from files on the local machine using a bundled Python script with structured JSON output.
What It Does
Convert
- Image formats:
png,jpg,webp,gif,bmp,tiff pdf -> docxxlsx -> csvxls -> csv(requires xlrd, not installed by default)docx -> pdf(requires LibreOffice)html/md/markdown -> pdf(requires wkhtmltopdf)
Inspect
- Basic metadata: size, MIME type, permissions, last modified
- Image: dimensions, color mode, format
- PDF: page count
- Excel: sheet names, row counts
Archive
- Create zip from files and directories
- Extract zip to directory (with ZipSlip protection)
Extract Text
- PDF, DOCX, XLSX, HTML, Markdown, image EXIF metadata
Quick Setup
bash skills/file-ops/scripts/setup.sh
Usage
Health check:
skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py health
Convert:
skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py convert --input /path/input.pdf --to docx
Inspect:
skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py inspect --input /path/file.pdf
Archive:
skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py archive --input /path/dir --output /path/out.zip
skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py archive --input /path/archive.zip --output /path/dest --extract
Extract text:
skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py extract-text --input /path/document.pdf
Use --output /path/output.ext with convert if you do not want the output written next to the input file.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.