Doctranslateio MCP

🚀 Doctranslate.io MCP 服务器

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

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

若要在 Cursor 中使用 DocTranslate MCP 服务器，请遵循以下步骤：

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

1. 打开 Cursor 设置，找到“工具与集成”。
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 服务器

若要在 Claude Desktop 中使用 DocTranslate MCP 服务器，请遵循以下步骤：

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

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

步骤 2：配置 claude_desktop_config.json

1. 打开 Claude Desktop。
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

保存配置后，重启 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

# 初始化 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 - 获取用户的翻译历史

✨ 主要特性

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

📦 安装指南

系统要求

• 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

💻 使用示例

基础用法

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)

高级用法

文档中未提及高级用法相关代码示例，若有更多使用场景和代码，可按照此格式补充。

📚 详细文档

认证与配置

如何创建 API 密钥

要开始使用 DocTranslate MCP 服务器，你需要按照以下步骤创建一个 API 密钥： 步骤 1： 访问 doctranslate.io/manage-api-key

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

步骤 2： 点击“创建 API 密钥”按钮

步骤 3： 复制生成的 API 密钥，用于你的配置

认证方法

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

客户端连接

客户端连接示例

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

📄 许可证

本项目采用 MIT 许可证。

版权所有 (c) 2025 Doctranslate.io

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

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

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

作者

• Doctranslate.io 团队

联系我们

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

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