File Converter

This MCP server provides multiple file conversion tools to help agents transform documents and images across common formats. With easy path-based or content-based inputs, you can convert Word to PDF, PDF to Word, images between formats, Excel to CSV, HTML/Markdown to PDF, and more, making it practical for automation and AI workflows.

How to use

You interact with this MCP server through an MCP client. Select the tool you need and provide either a file path or a base64-encoded file content. The server returns the converted file as a base64-encoded string along with success status. Use content-based input when you cannot rely on a file path, or when you want to ensure processing even if path lookup fails.

How to install

Prerequisites you need before installing and running this MCP server:

• Python 3.10 or newer is required.
• A Python environment or virtual environment is recommended.
• Access to the internet to install Python packages.

Install the server in your project environment:

pip install -e .

Start the MCP server in your development environment:

python start_mcp_server.py

Configure your MCP client to connect to this server using the following example. This sets up a stdio-based local server configuration named file_converter with the Python runtime and the script to start the MCP server.

{
  "mcpServers": {
    "file_converter": {
      "command": "python",
      "args": ["start_mcp_server.py"],
      "cwd": "."
    }
  }
}

Additional notes

You can alternatively install dependencies using the UV-based method if you prefer the UV mux approach. The server supports both path-based and content-based inputs for all conversion tools, and it includes robust logging and error handling to help you troubleshoot any issues.

Configuration tips and troubleshooting

• Ensure the server is running before attempting to connect from your MCP client. You should see the server process active after starting with the command shown above.

• If you encounter file path lookup issues, switch to content-based input by providing base64-encoded content of the file to convert.

• Review logs produced by the server to identify which tool is invoked, what input was provided, and where a conversion might fail. The server returns structured responses with a success flag and data or an error message.

Available tools

docx2pdf

Convert DOCX documents to PDF using a dedicated converter.

pdf2docx

Convert PDF documents to DOCX format.

convert_image

Convert between image formats such as JPG, PNG, and WEBP.

excel2csv

Convert Excel spreadsheets to CSV format.

html2pdf

Convert HTML or Markdown files to PDF.

convert_file

Generic file converter that handles multiple formats.

convert_content

Generic content-based converter that accepts base64 input and converts to the requested format.

docx2pdf_content

Convert DOCX content provided as base64 to PDF.

pdf2docx_content

Convert PDF content provided as base64 to DOCX.

markdown2pdf_content

Convert Markdown content provided as base64 to PDF.