File Converter MCP Server

What is File Converter MCP Server?

File Converter MCP Server is a local file operations tool designed for AI agents. It bundles a Python script that outputs structured JSON, enabling file conversion, inspection, archiving, and text extraction on the local machine.

How to use File Converter MCP Server?

Run the provided setup script, then invoke the Python script with commands such as convert, inspect, archive, or extract-text. Use --input and --output arguments to specify source and destination paths.

Key features of File Converter MCP Server?

• Convert between image formats (PNG, JPG, WebP, GIF, BMP, TIFF)
• Convert PDF to DOCX and XLSX/XLS to CSV
• Extract text from PDF, DOCX, XLSX, HTML, and Markdown
• Create and extract ZIP archives with ZipSlip protection
• Inspect file metadata, image dimensions, PDF page count, and Excel sheet info

Use cases of File Converter MCP Server?

• Convert a PDF to DOCX for further editing in word processors
• Inspect file metadata to verify type, size, and permissions
• Archive a project folder into a ZIP for easy transfer
• Extract text from documents for analysis or indexing

FAQ from File Converter MCP Server?

What extra dependencies are required for certain conversions?

Conversions from XLS to CSV need xlrd, DOCX to PDF requires LibreOffice, and HTML/Markdown to PDF requires wkhtmltopdf. These are not installed by default.

How does the archive extraction handle security risks?

Archive extraction includes ZipSlip protection to prevent directory traversal attacks when unzipping files.

Where does the output file get saved by default?

Output is saved next to the input file by default. Use the --output argument to specify a custom path.

How can I check if File Converter MCP Server is working?

Run the health check command: skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py health. It will return a JSON response indicating operational status.