Document Translation Mcp (doctranslate.io)

Doctranslate.io MCP サーバー

概要

Doctranslate.io MCP サーバーは、API を通じてドキュメント翻訳、テキスト翻訳、スライド作成サービスを提供する Model Context Protocol（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
# 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 サーバーを使用するには、次の手順に従ってください。

ステップ 1：Cursor の設定で MCP ツールを構成する

1. Cursor の設定を開き、「Tools and Intergrations」を探します
2. 「Add a custom MCP Server」をクリックします

ステップ 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 を設定する

Claude Desktop と互換性を持たせるため、main.py ファイルで streamable-http を stdio に変更します。

ステップ 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 サーバーをプログラムから使用することもできます。

インストール

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プランのオーナーまたは管理者である必要があります！！！

ステップ2： 「Create API Key」ボタンをクリックします。

ステップ3： 生成されたAPIキーをコピーし、設定で使用します。

認証方法

MCP Serverは2つの認証方法に対応しています。

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

クライアント接続

クライアント接続の例

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

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。

Copyright (c) 2025 Doctranslate.io

本ソフトウェアおよび関連するドキュメントファイル（以下「本ソフトウェア」）のコピーを入手したすべての人に対し、本ソフトウェアを無制限に取り扱うことを無償で許可します。これには、本ソフトウェアの使用、複製、変更、結合、公開、配布、サブライセンス、および販売の権利、ならびに本ソフトウェアを提供された人にこれらの権利を許可する権利が含まれます。ただし、以下の条件に従うものとします。

上記の著作権表示および本許諾表示は、本ソフトウェアのすべてのコピーまたは実質的な部分に含めるものとします。

本ソフトウェアは「現状有姿」で提供され、明示または黙示を問わず、商品性、特定目的への適合性、および権利非侵害の保証を含むがこれらに限定されない、いかなる保証もありません。作者または著作権者は、契約、不法行為、その他の行為であるかを問わず、本ソフトウェアまたは本ソフトウェアの使用その他の取り扱いに起因または関連する、あらゆる請求、損害、その他の責任について一切責任を負いません。

作者

• Doctranslate.io Team

お問い合わせ

• メール：[email protected]
• GitHub Issues：新しいissueを作成

---

⭐ このプロジェクトがお役に立ちましたら、スターをお願いします！