Doctranslateio MCP

🚀 Doctranslate.io MCP Server

Doctranslate.io MCP Server は、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
# または
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 で使用するには、以下の手順に従ってください。

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

DocTranslate MCP Server を Claude Desktop で使用するには、以下の手順に従ってください。

ステップ 1: main.py で stdio を構成する

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

ステップ 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 コードでのクイックスタート

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("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 キーを生成するには、チームサブスクリプションプランの所有者または管理者である必要があります！

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

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

認証方法

MCP サーバーは 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

クライアント接続

クライアント接続の例

# クライアント接続テストを実行する
python scripts/client/client.py

📄 ライセンス

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

Copyright (c) 2025 Doctranslate.io

このソフトウェアおよび関連するドキュメントファイル (「ソフトウェア」) のコピーを取得するすべての人に対して、無料で、制限なくソフトウェアを扱うことが許可されます。これには、使用、コピー、変更、マージ、公開、配布、サブライセンス、および/またはソフトウェアのコピーを販売する権利が含まれます。また、ソフトウェアが提供される人に対しても同じことが許可されます。ただし、以下の条件に従う必要があります。

上記の著作権表示とこの許諾表示は、ソフトウェアのすべてのコピーまたは相当部分に含まれる必要があります。

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

作者

• Doctranslate.io Team

連絡先

• メール: support@doctranslate.io
• GitHub の問題: 新しい問題を作成する

⭐ このプロジェクトが役立った場合は、スターを付けてください！