Doctranslate.io

Doctranslate MCP Server provides translation and slide creation services through an MCP interface, enabling you to translate documents and text, generate presentations from documents, and manage translation history using standardized MCP clients.

How to use

You interact with the Doctranslate MCP Server through an MCP client. You can perform text translations with formatting options, translate whole documents, and generate PowerPoint slides from documents. You can also check translation results and review your history. Start by connecting your MCP client to the server via the available endpoints, then choose the operation you need (text translate, document translate, or PPTX creation) and provide the required inputs. If your workflow involves a local setup, you can run the server locally and connect via a stdio-based client; if you prefer remote access, you can connect over HTTP to the designated MCP URL.

How to install

Prerequisites: you need Python 3.10 or newer and pip installed on your system. Docker and Docker Compose are optional but can simplify running the server.

Step 1: Prepare your environment and dependencies.

Step 2: Install Python dependencies.

Step 3: Run the server directly with Python or with a Python ASGI server.

Step 4: If you prefer Docker, run the container using the provided compose configuration.

HTTP MCP config example

Use this HTTP-based MCP connection to point your client at the remote server.

{
  "type": "http",
  "name": "doctranslate_mcp",
  "url": "http://mcp.doctranslate.io/mcp",
  "args": []
}

stdio MCP config examples for Claude Desktop

Claude Desktop can run the MCP server locally via stdio. Use one of the following configurations depending on your operating system.

{
  "type": "stdio",
  "name": "mcp_server_doctranslate_win",
  "command": "C:\\Users\\YourUsername\\doctranslate-mcp\\venv\\Scripts\\python.exe",
  "args": ["C:\\Users\\YourUsername\\doctranslate-mcp\\main.py"]
}

{
  "type": "stdio",
  "name": "mcp_server_doctranslate_linux",
  "command": "/home/username/doctranslate-mcp/venv/bin/python",
  "args": ["/home/username/doctranslate-mcp/main.py"]
}

Authentication and production access

You can authenticate requests in two ways: by passing an API key in request headers or by including the API key as a URL query parameter. If you need a hosted MCP service, use the production domain provided by the service and replace the local URL with the production URL.

Available tools (endpoints)

The server exposes a set of endpoints corresponding to its capabilities. You can translate text, translate documents, obtain translation results, convert documents to PPTX, and fetch a user’s translation history.

Available tools

mcp_doctranslate_translate_text

Translate text with various options such as target language and formatting.

mcp_doctranslate_translate_document

Translate documents in formats like PDF, DOCX, PPTX with optional tone and domain settings.

mcp_doctranslate_get_translation_result

Retrieve the results of a translation task.

mcp_doctranslate_convert_to_pptx

Convert translated content into PowerPoint slides.

mcp_doctranslate_get_user_history

Fetch the translation history for a user.