Doctranslate.io MCP Server

Doctranslate.io MCP 服务器

  ](docker-compose.yml)

概述

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

特性

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

系统要求

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

快速开始

安装

1. 克隆存储库：

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

1. 创建虚拟环境：

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

1. 安装依赖项：

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

🚀 使用游标快速入门

要将DocTranslate MCP服务器与光标一起使用，请执行以下步骤：

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

1. 打开光标设置，找到工具和集成
2. 单击添加自定义MCP服务器

步骤2：粘贴配置

使用标头

{
  "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服务器与Claude Desktop一起使用，请执行以下步骤：

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

使从…变成 streamable-http 向 stdio 在……里面 main.py 文件与Claude Desktop兼容。

第二步：配置claude_desktop_config json

1. 打开克劳德桌面
2. 首选 Claude>设置>开发人员>编辑配置
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以应用更改。

详细信息

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

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

🚀 Python代码快速入门

以编程方式使用MCP客户端

您还可以使用Python代码以编程方式使用DocTranslate MCP服务器：

安装

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密钥：

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

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

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

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

Step 2: Click Create API Key Button

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

Step 3: Copy Generated API Key

身份验证方法

MCP服务器支持两种身份验证方法：

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许可证获得许可。

版权所有 (c) 2025 Doctranslate.io

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

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

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

作者

• Doctranslate.io 团队

联系

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

______________________________________________________________________

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