Convert files between various formats, including images, documents, audio, video, and more.
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.
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 the uv
/uvx
executables (or uv.exe
/uvx.exe
on Windows).
Using uvx
(recommended):
{
"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"
}
}
}
}
Using local uvx
:
{
"mcpServers": {
"file-convert": {
"command": "uvx",
"args": ["--from", "/home/User/file-convert-mcp", "file-convert-mcp"],
"env": {
"CONVERT_GURU_API_KEY": "your_api_key_here"
}
}
}
}
Also, see this guide on how to set up MCP tools in Claude Desktop.
To install file-convert-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @convertguru/file-convert-mcp --client claude
Get started with local development by following these steps:
1. Clone the repository:
git clone https://github.com/convertguru/file-convert-mcp.git
2. Fetch and cache Python dependencies (optional, uvx
handles this automatically):
cd file-convert-mcp
uv sync
cd ..
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 various uv
commands:
# 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
5. Modify the server logic if needed:
Edit the main server file located at src/file_convert_mcp/server.py.
6. Clearing the uv
Cache (if needed):
If uv
has cached an older version of the code in ~/.cache/uv
, you might need to clear the cache. Alternatively, use uv
with the -n
or --no-cache
option 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 the ext_out
parameter.Visit us https://convert.guru
This project is licensed under the MIT License - see the LICENSE file for complete details.
A server providing comprehensive file system operations, automatically downloaded and built on first use.
Fast Windows file search using Everything SDK
Parses various file formats using the 302.AI API, requiring a 302AI_API_KEY.
A read-only MCP server for querying live FTP data using the CData JDBC Driver.
Provides shell access to execute commands and interact with the local file system.
A server for performing filesystem operations such as reading/writing files, managing directories, and searching.
Perform filesystem operations within specified directories.
Visualize directory structures with real-time updates, configurable depth, and smart exclusions for efficient project navigation.
A high-performance MCP server for comprehensive JSON file operations, including reading, writing, and advanced querying, optimized for LLM interactions.
Extract text, images, and perform OCR on PDF documents using Tesseract OCR.