File Convert MCP Server
About
Convert files between various formats, including images, documents, audio, video, and more.
Details
- Author
- convertguru
- Downloads
- 408
- Categories
- File Management, Other, Media, Productivity
Jump to
- Intelligent file type detection using AI, TrID, and magic bytes.
- Versatile conversion to PDF, JPG, PNG, TXT, HTML, MP3, MP4, CSV.
- Supports a vast range of image formats, including legacy ones.
- Converts office documents to PDF, TXT, or HTML.
- Converts audio/video to MP3 or MP4.
- Converts databases to CSV.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
File Convert MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.12+ and the Python uv tool. Add the server configuration (using uvx or local uv) to your desktop app’s MCP settings, optionally setting the CONVERT_GURU_API_KEY environment variable. Then invoke the detect_file_type and convert_file tools via MCP.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"file convert mcp server": {
"file-convert": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/convertguru/file-convert-mcp.git",
"file-convert-mcp"
],
"env": {
"CONVERT_GURU_API_KEY": "your_api_key_here"
}
}
}
}
}McpServers
{
"file-convert": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/convertguru/file-convert-mcp.git",
"file-convert-mcp"
],
"env": {
"CONVERT_GURU_API_KEY": "your_api_key_here"
}
}
}A Model Context Protocol (MCP) server for converting files between various formats.
File Convert is an MCP server designed to handle the conversion of a wide array of file formats, including images, office documents, audio, video, text, and data files. It aims to provide seamless transformation into popular formats such as PDF, JPG, MP4, and HTML, among others. This server offers a set of powerful tools to convert diverse file types into easily accessible and widely compatible formats like PDF, JPG, PNG, TXT.
- Intelligent File Type Detection:Employs a combination of AI, TrID, and magic bytes for accurate file type identification.
- Versatile File Conversion:Supports conversion between numerous file types and the following popular formats:
- Images:Handles a vast range of formats, including many legacy ones. Converts to PDF, JPG, PNG.
- Office Documents:Converts to PDF, TXT, HTML.
- Audio/Video:Converts to MP3, MP4.
- Databases:Converts to CSV.
- Various Files:Offers conversion capabilities for other file types as well.
- Python:Version 3.12 or higher is required.
- uv Tool:Install thePython uv toolfor efficient dependency management and easy execution of the MCP server.
- API Key (Development):As of May 2025, the MCP is in its testing phase, andno API key is currently requiredfor development. For future production use, pleasecontact the Convert.Guru teamto obtain an API key.
To integrate this server with your desktop application, add the following configuration to your app's server settings. If necessary, adjust the absolute path to theuv/uvxexecutables (oruv.exe/uvx.exeon Windows).
{ "mcpServers": { "file-convert": { "command": "uvx", "args": ["--from", "git+https://github.com/convertguru/file-convert-mcp.git", "file-convert-mcp"], "env": { "CONVERT_GURU_API_KEY": "your_api_key_here" } } } }
If you have cloned the repository locally (adjust paths as needed):
{ "mcpServers": { "file-convert": { "command": "/home/User/.local/bin/uv", "args": ["--directory", "/home/User/file-convert-mcp/src/file_convert_mcp", "run", "server.py"], "env": { "CONVERT_GURU_API_KEY": "your_api_key_here" } } } }
{ "mcpServers": { "file-convert": { "command": "uvx", "args": ["--from", "/home/User/file-convert-mcp", "file-convert-mcp"], "env": { "CONVERT_GURU_API_KEY": "your_api_key_here" } } } }
The MCP server supports the following environment variables:
- CONVERT_GURU_API_KEY: Your Convert.Guru API key (optional for development)
- TRANSPORT: Transport method for the MCP server
- "stdio"(default): Standard input/output transport
- "http": HTTP transport (streamable) with REST API endpoints
When using HTTP transport, the server provides additional endpoints:
- GET /health- Health check endpoint
- GET /tools- List of available MCP tools
Also, see this guide on how toset up MCP tools in Claude Desktop.
To install file-convert-mcp for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install @convertguru/file-convert-mcp --client claude
Get started with local development by following these steps:
git clone https://github.com/convertguru/file-convert-mcp.git
2. Fetch and cache Python dependencies (optional,uvxhandles this automatically):
3. Create .env file with your (optional for now) API key:
echo "CONVERT_GURU_API_KEY=your_api_key_here" > file-convert-mcp/.env
4. Run the MCP server locally using variousuvcommands:
# Using uvx with .env file from the local directory cd file-convert-mcp UV_ENV_FILE=.env uvx --from ./file-convert-mcp file-convert-mcp # OR using uv directly to run the server script uv run file-convert-mcp/src/file_convert_mcp/server.py # OR specifying the directory for uv uv --directory file-convert-mcp/src/file_convert_mcp run server.py # OR navigating into the server directory cd file-convert-mcp/src/file_convert_mcp uv run server.py # OR using uvx to fetch the core from the GitHub repository + local .env file UV_ENV_FILE=.env uvx --from git+https://github.com/convertguru/file-convert-mcp.git file-convert-mcp # OR run with HTTP transport on custom port TRANSPORT=http PORT=9000 uv run file-convert-mcp/src/file_convert_mcp/server.py # OR run with stdio transport (default) TRANSPORT=stdio uv run file-convert-mcp/src/file_convert_mcp/server.py
5. Create .env file with your configuration (optional for now):
# Basic configuration echo "CONVERT_GURU_API_KEY=your_api_key_here" > file-convert-mcp/.env # OR with transport configuration echo "CONVERT_GURU_API_KEY=your_api_key_here" > file-convert-mcp/.env echo "TRANSPORT=http" >> file-convert-mcp/.env echo "PORT=8000" >> file-convert-mcp/.env
6. Modify the server logic if needed:Edit the main server file located atsrc/file_convert_mcp/server.py.
7. Clearing theuvCache (if needed):Ifuvhas cached an older version of the code in~/.cache/uv, you might need to clear the cache. Alternatively, useuvwith the-nor--no-cacheoption to bypass it.
The MCP server provides the following tools:
- detect_file_type: Analyzes the first 200 bytes of an uploaded file and uses the Convert.Guru API to determine its type.
- convert_file: Converts a given file to a specified output format. The desired file extension should be passed as theext_outparameter.
This project is licensed under the MIT License - see theLICENSEfile for complete details.
Free file conversion between 999 routes (images, video, audio, documents, data, fonts, ebooks, archives) — no API key required.
62 format-aware tools for AI to read and edit Word, Excel, and PDF files with precision — plus academic document linting for Indonesian standards.
Convert files (DOCX, XLSX, PPTX, images), HTML, and Markdown to pixel-perfect PDFs — npx stdio or hosted Streamable HTTP, free API key in one click.
MCP server for BulkRender — generate bulk DOCX and PDF documents from Claude, Cursor, Windsurf, and any MCP-compatible AI assistant
Universal document generation and conversion MCP. Generate PDF/DOCX/XLSX from templates+JSON (invoices, contracts, reports), batch generation, 100+ format conversions.
A server for reading and converting documents between PDF, DOCX, and Markdown formats using marker-pdf and pandoc.
MCP for work with docx files. Make copy format from docx files.
Convert Excel and Apple Numbers files to PDF format.
Convert any file or URL to clean AI-ready Markdown. Supports PDF, Word, Excel, PowerPoint, YouTube, ArXiv, Wikipedia, and 18 more formats. Up to 63% fewer tokens for ChatGPT and Claude. Free, no API key required.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
