Doctranslate.io MCP Server

Overview

Doctranslate.io MCP Server is a Model Context Protocol (MCP) server that provides document translation, text translation, and slide creation services through API. The server supports multilingual translation, text translation with formatting options, slide creation from documents, and translation history management.

Features

🔄 Document Translation - Multilingual document translation with tone and domain options
📝 Text Translation - Translate text with multiple formatting options
📄 Slide Creation - Create presentation slides from documents with custom templates
📊 History Management - Translation history tracking with filtering

System Requirements

Python >= 3.10
pip (Python package manager)
Docker & Docker Compose (optional)

Quick Start

Installation

Clone repository:

git clone https://github.com/thinkprompt/doctranslateio-mcp.git
cd doctranslate-mcp-server

Create virtual environment:

python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate  # Windows

Install dependencies:

pip install -r requirements.txt

Running the Application

Direct execution:

python main.py

With uvicorn:

uvicorn main:server --host 0.0.0.0 --port 8000 --reload

With Docker:

docker-compose up -d

Server will run at: http://localhost:8000

🚀 Quickstart with Cursor

To use DocTranslate MCP Server with Cursor, follow these steps:

Step 1: Configure MCP Tool in Cursor Settings

Open Cursor Settings and find Tools and Intergrations
Click at Add a custom MCP Server

Step 2: Paste the config

Using Headers

{
  "mcpServers": {
    "doctranslate-mcp-server": {
      "url": "http://mcp.doctranslate.io/mcp",
      "type": "streamable-http",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

Using Query Parameter

{
  "mcpServers": {
    "doctranslate-mcp-server": {
      "url": "http://mcp.doctranslate.io/mcp?api_key=YOUR_API_KEY",
      "type": "streamable-http"
    }
  }
}

🚀 Quickstart with Claude Desktop

Setting up MCP Server for Claude Desktop

To use DocTranslate MCP Server with Claude Desktop, follow these steps:

Step 1: Configure stdio in main.py

Change from streamable-http to stdio in main.py file to be compatible with Claude Desktop.

Step 2: Configure claude_desktop_config.json

Open Claude Desktop
Go to Claude > Settings > Developer > Edit Config
Edit the claude_desktop_config.json file to include the following configuration:

{
  "mcpServers": {
    "mcp-server-doctranslate": {
      "command": "path to your python environment",
      "args": ["path to your folder\\main.py"]
    }
  }
}

Example configurations:

On Windows:

{
  "mcpServers": {
    "mcp-server-doctranslate": {
      "command": "C:\\Users\\YourUsername\\doctranslate-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\YourUsername\\doctranslate-mcp\\main.py"]
    }
  }
}

On Linux/Mac:

{
  "mcpServers": {
    "mcp-server-doctranslate": {
      "command": "/home/username/doctranslate-mcp/venv/bin/python",
      "args": ["/home/username/doctranslate-mcp/main.py"]
    }
  }
}

Step 3: Restart Claude Desktop

After saving the configuration, restart Claude Desktop to apply the changes.

More Information

For detailed information about setting up MCP servers, please refer to:

Official Website: https://modelcontextprotocol.io/quickstart/user

🚀 Quickstart with Python Code

Using the MCP Client Programmatically

You can also use the DocTranslate MCP Server programmatically with Python code:

Installation

pip install langchain_mcp_adapters

Basic Usage

from langchain_mcp_adapters.client import MultiServerMCPClient
import asyncio

# Initialize MCP client
client = MultiServerMCPClient(
    {
        "doctranslate": {
            "transport": "streamable_http",
            "url": "http://ip_address:port/mcp",
            "headers": {
              "api_key": "YOUR_API_KEY"
            }
        },
    }
)

# Get available tools asynchronously
tools = asyncio.run(client.get_tools())
print("Available tools:", tools)

Available Tools

The MCP Server provides the following tools:

mcp_doctranslate_translate_text - Translate text with various options
mcp_doctranslate_translate_document - Translate documents (PDF, DOCX, PPTX, etc.)
mcp_doctranslate_get_translation_result - Get translation task results
mcp_doctranslate_convert_to_pptx - Convert documents to PowerPoint format
mcp_doctranslate_get_user_history - Get user's translation history

Authentication & Configuration

How to Create API Key

To get started with DocTranslate MCP Server, you need to create an API key by following these steps:

Step 1: Visit doctranslate.io/manage-api-key

Step 1: Visit API Key Management Page Or click on the button API Key

Notice: To generate an API key on Doctranslate, you must be the owner or an administrator of a Team Subscription plan !!!

Step 2: Click "Create API Key" button

Step 3: Copy the generated API Key for use in your configuration

Step 3: Copy Generated API Key

Authentication Methods

The MCP Server supports two authentication methods:

Headers Authentication - Pass API key in request headers
Query Parameter Authentication - Pass API key as URL parameter

Both methods provide secure access to the translation services.

Production Domain

If you want to use our hosted MCP service, replace the local URL with our production domain:

Production URL: http://mcp.doctranslate.io

Documentation

For detailed API documentation and implementation guides:

Official Documentation: https://developer.doctranslate.io/document-translation-api/translation-api/api-v3
Interactive API Docs: https://api-doc.doctranslate.io/

Project Structure

doctranslate-mcp-server/
├── src/
│   └── agents/tools/
│       ├── doctranslate.py
│       └── reader.py
├── scripts/
│   └── client/
│       └── client.py
├── docs/
│   └── doctranslate.io.md
├── main.py
├── requirements.txt
├── Dockerfile
├── docker-compose.yml
└── README.md

Client Connection

Client Connection Example

# Run client connection test
python scripts/client/client.py

License

This project is licensed under the MIT License.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Authors

Doctranslate.io Team

Contact

Email: support@doctranslate.io
GitHub Issues: Create new issue

⭐ If this project is helpful, please give us a star!

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

A Model Context Protocol server providing document translation, text translation, and slide creation services with multilingual support and formatting options.

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
1
Python
MIT License
MCP Docling Server
zanetworker
-
security
A
license
-
quality
A server that provides document processing capabilities using the Model Context Protocol, allowing conversion of documents to markdown, extraction of tables, and processing of document images.
Last updated -
12
Python
MIT License
AiryLark MCP Translation Server
wizd
-
security
F
license
-
quality
A ModelContextProtocol server providing high-quality translation services with a three-stage translation workflow (analysis, segmented translation, full-text review) that supports multiple languages and integrates with Claude and OpenAI-compatible models.
Last updated -
19
TypeScript
MarkItDown MCP Server
canlgz
A
security
A
license
A
quality
A Model Context Protocol server that converts various file formats (PDF, PowerPoint, Word, Excel, Images, etc.) to Markdown to make them accessible to LLMs.
Last updated -
1
MIT License

View all related MCP servers