Document Translation Mcp (doctranslate.io)

Doctranslate.io MCP Server

概述

Doctranslate.io MCP Server 是一个模型上下文协议（MCP）服务，通过 API 提供文档翻译、文本翻译和幻灯片创建服务。该服务支持多语言翻译、带格式选项的文本翻译、根据文档创建幻灯片，以及翻译历史管理。

功能

• 🔄 文档翻译 - 支持语气和领域选项的多语言文档翻译
• 📝 文本翻译 - 使用多种格式选项翻译文本
• 📄 幻灯片创建 - 使用自定义模板根据文档创建演示文稿幻灯片
• 📊 历史管理 - 支持筛选的翻译历史跟踪

系统要求

• Python >= 3.10
• pip（Python 包管理器）
• Docker 和 Docker Compose（可选）

快速开始

安装

1. 克隆仓库：

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

2. 创建虚拟环境：

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

3. 安装依赖：

pip install -r requirements.txt

运行应用

直接运行：

python main.py

使用 uvicorn：

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

使用 Docker：

docker-compose up -d

服务将在 http://localhost:8000 上运行。

🚀 使用 Cursor 快速开始

按照以下步骤在 Cursor 中使用 DocTranslate MCP Server：

步骤 1：在 Cursor 设置中配置 MCP 工具

1. 打开 Cursor 设置并找到 Tools and Intergrations
2. 点击 Add a custom MCP Server

步骤 2：粘贴配置

使用 Headers

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

使用 Query Parameter

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

🚀 使用 Claude Desktop 快速开始

为 Claude Desktop 设置 MCP 服务

按照以下步骤在 Claude Desktop 中使用 DocTranslate MCP Server：

步骤 1：在 main.py 中配置 stdio

在 main.py 文件中将 streamable-http 改为 stdio，以兼容 Claude Desktop。

步骤 2：配置 claude_desktop_config.json

1. 打开 Claude Desktop
2. 前往 Claude > Settings > Developer > Edit Config
3. 编辑 claude_desktop_config.json 文件并加入以下配置：

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

配置示例：

在 Windows 上：

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

在 Linux/Mac 上：

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

步骤 3：重启 Claude Desktop

保存配置后，重启 Claude Desktop 以应用更改。

更多信息

有关设置 MCP 服务的详细信息，请参阅：

• 官方网站：https://modelcontextprotocol.io/quickstart/user

🚀 使用 Python 代码快速开始

以编程方式使用 MCP 客户端

你也可以使用 Python 代码以编程方式调用 DocTranslate MCP Server：

安装

pip install langchain_mcp_adapters

基本用法

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)

可用工具

MCP 服务提供以下工具：

• mcp_doctranslate_translate_text - 使用各种选项翻译文本
• mcp_doctranslate_translate_document - 翻译文档（PDF、DOCX、PPTX 等）
• mcp_doctranslate_get_translation_result - 获取翻译任务结果
• mcp_doctranslate_convert_to_pptx - 将文档转换为 PowerPoint 格式
• mcp_doctranslate_get_user_history - 获取用户的翻译历史

身份验证与配置

如何创建 API 密钥

要开始使用 DocTranslate MCP Server，请按以下步骤创建 API 密钥：

步骤 1： 访问 doctranslate.io/manage-api-key

注意： 要在 Doctranslate 上生成 API 密钥，你必须是 Team Subscription plan 的所有者或管理员！！！

步骤 2： 点击“Create API Key”按钮

步骤 3： 复制生成的 API Key，以便在配置中使用

身份验证方法

MCP Server 支持两种身份验证方法：

1. 请求头身份验证 - 在请求头中传递 API 密钥
2. 查询参数身份验证 - 将 API 密钥作为 URL 参数传递

这两种方法都能安全地访问翻译服务。

生产环境域名

如果要使用我们托管的 MCP 服务，请将本地 URL 替换为我们的生产环境域名：

生产环境 URL：http://mcp.doctranslate.io

文档

如需详细的 API 文档和实现指南，请参阅：

• 官方文档：https://developer.doctranslate.io/document-translation-api/translation-api/api-v3
• 交互式 API 文档：https://api-doc.doctranslate.io/

项目结构

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

客户端连接

客户端连接示例

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

许可证

本项目采用 MIT License 授权。

Copyright (c) 2025 Doctranslate.io

特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人，不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再授权和／或销售本软件副本的权利，并允许本软件的接收者这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或实质性部分中。

本软件按“原样”提供，不提供任何明示或默示的保证，包括但不限于适销性、特定用途适用性和不侵权的保证。在任何情况下，作者或版权持有人均不对因本软件或本软件的使用或其他交易而引起、产生或与之相关的任何索赔、损害或其他责任负责，无论是合同诉讼、侵权行为还是其他方面。

作者

• Doctranslate.io 团队

联系方式

• Email：[email protected]
• GitHub Issues：创建新问题

---

⭐ 如果这个项目对你有帮助，请给我们点个星！