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 問題：創建新問題

⭐ 如果這個項目對你有幫助，請給我們點個星！