File Convert

A Model Context Protocol (MCP) server for converting files between different formats

python

4

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "convertguru-file-convert-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/convertguru/file-convert-mcp.git",
        "file-convert-mcp"
      ],
      "env": {
        "PORT": "8000",
        "TRANSPORT": "stdio",
        "CONVERT_GURU_API_KEY": "your_api_key_here"
      }
    }
  }
}

File Convert MCP Server is an MCP server that handles transforming a wide range of file formats into widely usable outputs such as PDF, JPG, MP4, and HTML. It detects file types intelligently and provides straightforward tools to convert images, documents, audio, video, text, and data files, making it easy to integrate file conversions into your workflows.

How to use

You can use the File Convert MCP Server by connecting an MCP client to one of its supported transport modes. The server exposes tools to detect the type of an uploaded file and to convert a file into a chosen output format. To start, run the MCP server locally using one of the provided commands, then send files to the server for type detection and conversion. If you are using HTTP transport later, the server will offer REST-style endpoints for health checks and tool discovery.

How to install

Prerequisites: Python 3.12 or higher and the uv tool for running MCP servers.

Clone the File Convert MCP repository to your machine.

Create an optional environment file to store your API key (used for development). Use a placeholder value if you do not have an API key yet.

Run the MCP server locally using one of the available commands. Choose the command that matches your environment.

If you prefer HTTP transport on a custom port, set TRANSPORT and PORT accordingly when starting the server.

Configuration and running instructions

{
  "mcpServers": {
    "file_convert_git": {
      "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"
      }
    },
    "file_convert_localuv": {
      "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"
      }
    },
    "file_convert_uvx_local": {
      "command": "uvx",
      "args": ["--from", "/home/User/file-convert-mcp", "file-convert-mcp"],
      "env": {
        "CONVERT_GURU_API_KEY": "your_api_key_here"
      }
    }
  }
}

Notes on transport and endpoints

The server supports a stdio transport for local development and an http transport for streaming REST-style interactions. When using the http transport, you can run the server with environment variables that enable REST endpoints such as health checks and tool discovery.

Available tools

detect_file_type

Analyzes the first portion of an uploaded file to identify its type using a combination of AI, TrID, and magic bytes, then returns the detected type.

convert_file

Converts a given file to a specified output format, with the desired extension passed as ext_out.