Omni File Format Converter

Omni File Format converter MCP enables you to convert documents between formats using an MCP server. It provides a remote HTTP endpoint for access via an OneKey router and a local, self-hosted runtime to run the converter on your machine or server.

How to use

You can connect to the Omni File Format converter MCP in two ways: via a remote HTTP MCP URL or by running the MCP locally on your machine. The remote URL uses an OneKey access key to authorize your requests. The local runtime lets you start a self-hosted server that you control.

How to install

Prerequisites depend on how you run the MCP. You can use a remote HTTP endpoint or run the MCP locally. The following instructions show the local runtime setup and the HTTP access example.

# Expose an OneKey access key for router access (example key shown)
DEEPNLP_ONEKEY_ROUTER_ACCESS=BETA_TEST_KEY_OCT_2025

{
  "mcpServers": {
    "omni-file-converter-mcp": {
      "url": "https://agent.deepnlp.org/mcp?server_name=omni-file-converter-mcp&onekey=BETA_TEST_KEY_OCT_2025"
    }
  }
}

{
  "mcpServers": {
    "omni-file-converter-mcp": {
      "url": "https://agent.deepnlp.org/mcp?server_name=omni-file-converter-mcp&onekey=BETA_TEST_KEY_OCT_2025"
    }
  }
}

# Local clone and run (example)
git clone https://github.com/AI-Hub-Admin/omni-file-converter-mcp
cd omni-file-converter-mcp

{
  "mcpServers": {
    "omni-file-converter-mcp": {
      "command": "uv",
      "args": ["--directory", "/path_to_folder/omni-file-converter-mcp/src/omni_file_converter_mcp", "run", "server.py"]
    }
  }
}

# Start using the local MCP configuration (example)

Note: The local run example uses the uv runtime with a directory pointing to the MCP source, and runs the server script directly as shown above.

## Additional setup details

If you prefer a remote setup, you can use the OneKey router access key to connect to the remote MCP endpoint. The OneKey configuration is shared under a corresponding JSON block above.

## Notes and sources

The Omni File Format converter MCP supports converting documents from PDFs and other formats to image or other target formats. It includes a dedicated tool `pdf_to_image` that processes a PDF file and outputs image files for each page. The tool arguments include the input file path, the desired output format, and an optional base output name.

## Troubleshooting

- Ensure the OneKey access key matches the endpoint configuration when using the HTTP URL.
- If you run the MCP locally, confirm the directory path to your `server.py` script is correct and that the runtime (uv) is installed and accessible in your environment.
- If you encounter permission or network errors, verify that your environment allows outbound HTTP requests to the remote MCP URL or that your local firewall permits local socket usage for the stdio runtime.

## Available tools

### pdf\_to\_image

Converts a PDF file to image files. Takes the input file path, an output format, and an optional output file name. Returns the paths to the generated images.