Doctranslate.io MCP Server

概述

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

功能

• 🔄 文档翻译 - 多语言文档翻译，带有语气和领域选项
• 📝 文本翻译 - 带有多种格式选项的文本翻译
• 📄 幻灯片创建 - 使用自定义模板从文档创建演示幻灯片
• 📊 历史管理 - 带有过滤功能的翻译历史跟踪

系统需求

• 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
# 或
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 快速开始

要使用 DocTranslate MCP Server 与 Cursor，请按照以下步骤操作：

第一步：在 Cursor 设置中配置 MCP 工具

1. 打开 Cursor 设置并找到工具和集成部分
2. 单击添加自定义 MCP 服务器

第二步：粘贴配置

使用头部信息

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

使用查询参数

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

🚀 使用 Claude Desktop 快速开始

为 Claude Desktop 配置 MCP 服务器

要使用 DocTranslate MCP Server 与 Claude Desktop，请按照以下步骤操作：

第一步：在 main.py 中配置 stdio

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

第二步：配置 claude_desktop_config.json

1. 打开 Claude Desktop
2. 转到 Claude > 设置 > 开发者 > 编辑配置
3. 编辑 claude_desktop_config.json 文件，包括以下配置：

{
  "mcpServers": {
    "mcp-server-doctranslate": {
      "command": "你的 python 环境路径",
      "args": ["你的文件夹路径\\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"]
    }
  }
}

第三步：重启 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

# 初始化 MCP 客户端
client = MultiServerMCPClient(
    {
        "doctranslate": {
            "transport": "streamable_http",
            "url": "http://ip_address:port/mcp",
            "headers": {
              "api_key": "YOUR_API_KEY"
            }
        },
    }
)

# 异步获取可用工具
tools = asyncio.run(client.get_tools())
print("可用工具:", 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 密钥：

第一步： 访问 doctranslate.io/manage-api-key

注意： 在 Doctranslate 上生成 API 密钥，您必须是团队订阅计划的所有者或管理员！！！

第二步： 单击“创建 API 密钥”按钮

第三步： 复制生成的 API 密钥用于您的配置

认证方法

MCP 服务器支持两种认证方法：

1. 头部认证 - 在请求头部传递 API 密钥
2. 查询参数认证 - 作为 URL 参数传递 API 密钥

两种方法都提供了对翻译服务的安全访问。

生产域名

如果您想使用我们的托管 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

客户端连接

客户端连接示例

# 运行客户端连接测试
python scripts/client/client.py

许可证

本项目根据 MIT 许可证发布。

版权所有 (c) 2025 Doctranslate.io

在此授权任何人免费获得此软件及其相关文档文件（以下简称“软件”），在不受限制的情况下使用软件，包括但不限于使用、复制、修改、合并、出版、分发、再许可和/或出售软件副本的权利，以及允许向其提供软件的人这样做，但需遵守以下条件：

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

软件按“原样”提供，不附带任何形式的保证，无论是明示的还是默示的，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人都不对因软件或其使用或其他交易而引起的任何索赔、损害或其他责任承担任何责任，无论是在合同行为、侵权行为或其他行为中。

作者

• Doctranslate.io 团队

联系方式

• 邮件：support@doctranslate.io
• GitHub Issues：创建新问题

---

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