Agents-MCP-Hackathon/universal-file-converter

MCP Server: Universal File Converter

This project includes an MCP (Model Context Protocol Servers) server for universal file conversion.

• —Gradio App URL: https://huggingface.co/spaces/Agents-MCP-Hackathon/universal-file-converter
• —MCP Server URL: https://agents-mcp-hackathon-universal-file-converter.hf.space/gradio_api/mcp/sse

Available MCP Tools:

• —universal_file_converter_convert_local_file: Convert a local document to a different format. This requires the server to be running locally. Parameters: local_file_path (string), output_format (string, default: "pdf").
• —universal_file_converter_convert_from_url: Convert a document from a URL to a different format. Parameters: document_url (string), output_format (string, default: "pdf").

Note on API Usage: If you encounter API errors, it might be due to the free version's limit of 250 requests. To overcome this, consider duplicating the Space and adding your own https://www.convertapi.com/ API key as environmental variable.

Watch the demo video: Universal File Converter MCP Server Demo (Agents MCP Hackathon) 

Integration with MCP clients

Integration

To integrate this MCP into clients that support SSE (e.g., Cursor, Windsurf, Cline), add the following configuration to your MCP config:

{
  "mcpServers": {
    "gradio": {
      "url": "https://agents-mcp-hackathon-universal-file-converter.hf.space/gradio_api/mcp/sse"
    }
  }
}

For clients that only support stdio, such as Claude desktop, first install Node.js from the official website (https://nodejs.org/). Then, you can use the following command:

{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://agents-mcp-hackathon-universal-file-converter.hf.space/gradio_api/mcp/sse",
        "--transport",
        "sse-only"
      ]
    }
  }
}

Prompt Example

Can you please convert the https://raw.githubusercontent.com/kingabzpro/bbc-news-class-mlops/refs/heads/master/README.md file into PDF

Supported File Formats

pdf, docx, doc, txt, rtf, odt, html, epub, png, jpg, jpeg, gif, bmp, tiff, webp, svg, xlsx, xls, csv, ods, pptx, ppt, odp, mp4, avi, mov, wmv, flv, webm, mp3, wav, flac, aac, ogg