Youtube Translate

YouTube Translate MCP

YouTube の動画から文字起こし、翻訳、要約を取得できる、YouTube Translate API にアクセスするための Model Context Protocol (MCP) サーバーです。

機能

• YouTube 動画の文字起こしを取得
• 文字起こしをさまざまな言語に翻訳
• SRT または VTT 形式の字幕を生成
• 動画コンテンツの要約を作成
• 動画内の特定のコンテンツを検索

ホスト型リモート MCP

本番環境のエンドポイント：ストリーミング可能な HTTP を使用する https://api.youtubetranslate.com/mcp。

認証には OAuth を推奨します。サーバーは保護されたリソースの検出チャレンジを返し、API はパブリッククライアントの登録、S256 PKCE、所有者の同意、有効期間の短いアクセストークン、リフレッシュトークンのローテーション、取り消しに対応しています。アカウントを連携した後、Authorization: Bearer <access token> を送信してください。

レガシークライアントでは、アカウント所有のユーザーキーを各リクエストで送信してください：

X-API-Key: ut-user-...

ローカルの stdio では、引き続き YOUTUBE_TRANSLATE_API_KEY を使用できます。ホスト型のリクエストはすべて、ツールの検出または呼び出しの前に認証され、トランスポートはステートレスです。共有の管理者認証情報は使用しません。アカウントページには、アシスタントのトークンファミリーを取り消す切断操作があります。

ツール

• start_video：YouTube の URL をキューに追加し、ジョブ ID を返します。
• get_video_status：ジョブ ID または YouTube ID で処理状態を確認します。
• get_transcript：テキストまたはタイムスタンプ付きセグメントを返します。
• get_translation：翻訳された文字起こしをリクエストして返します。
• get_subtitles：翻訳された SRT または VTT を生成して返します。
• get_summary：短、中、長の要約を生成します。
• search_video：全体位置とタイムスタンプを含む箇所を検索します。

高レベルのツールは、最大 TOOL_TIMEOUT_SECONDS（デフォルトは 75 秒）まで待機します。長い動画では処理中のメッセージが返されるため、エージェントは再試行してください。

リモートで実行

uv run youtube-translate-mcp --transport streamable-http --host 0.0.0.0 --port 8000

MCP_ALLOWED_HOSTS には、リバースプロキシで使用するパブリックホスト名を含める必要があります。X-API-Key のないリクエストは拒否されます。

ChatGPT と Claude

クライアントが対応している場合は、OAuth を使用してホスト型 URL に接続してください。アカウント所有の API キーヘッダーも代替手段として利用できます。本番環境の OAuth フローと MCP 呼び出しは外部クライアントで検証済みですが、ChatGPT や Claude 自身の接続 UI では検証されていません。Google アカウントでの登録には、引き続きこのアプリケーションに設定された OIDC クライアントが必要です。公開ディレクトリでの審査と申請は完了していません。チャット内での購入を約束しないでください。現在の ChatGPT プラグインのルールでは、プラグインを通じたデジタルクレジットの販売は禁止されています。

インストール

Smithery を使ったインストール

Smithery を使って Claude Desktop に youtube-translate-mcp を自動的にインストールするには：

npx -y @smithery/cli install @brianshin22/youtube-translate-mcp --client claude

手動でのインストール

このパッケージには Python 3.12 以降が必要です：

# Using uv (recommended)
uv pip install youtube-translate-mcp

# Using pip
pip install youtube-translate-mcp

または、ソースからインストールします：

# Clone the repository
git clone https://github.com/yourusername/youtube-translate-mcp.git
cd youtube-translate-mcp

# Using uv (recommended)
uv pip install -e .

# Using pip
pip install -e .

使用方法

サーバーを実行するには：

# Using stdio transport (default)
YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp

# Using SSE transport
YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp --transport sse --port 8000

Docker

Docker を使ってサーバーを実行することもできます：

# Build the Docker image
docker build -t youtube-translate-mcp .

# Run with stdio transport
docker run -e YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp

# Run with SSE transport
docker run -p 8000:8000 -e YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp --transport sse

環境変数

• YOUTUBE_TRANSLATE_API_KEY：必須。YouTube Translate API にアクセスするための API キーです。

Smithery を使ったデプロイ

このパッケージには、Smithery を使った簡単なデプロイのために smithery.yaml ファイルが含まれています。

デプロイするには、YOUTUBE_TRANSLATE_API_KEY 設定パラメーターに YouTube Translate API キーを設定してください。

開発

前提条件

• Python 3.12+
• Docker（任意）

セットアップ

# Create and activate a virtual environment using uv (recommended)
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies using uv
uv pip install -e .

# Alternatively, with standard tools
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

Claude Desktop でのテスト

Claude Desktop（macOS／Windows のみ）でテストするには、~/Library/Application Support/Claude/claude_desktop_config.json にある Claude Desktop の設定ファイルにサーバーを追加する必要があります。

方法 1：ローカル開発

ローカルの開発バージョンをテストする場合は、この方法を使用してください：

{
    "mcpServers": {
        "youtube-translate": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/youtube-translate-mcp",
                "run",
                "-m", "youtube_translate_mcp"
            ],
            "env": {
              "YOUTUBE_TRANSLATE_API_KEY": "YOUR_API_KEY"
            }
        }
    }
}

/ABSOLUTE/PATH/TO/youtube-translate-mcp を、プロジェクトディレクトリの実際のパスに置き換えてください。

方法 2：Docker ベースのテスト

Docker を使用してテストする場合は、こちらをお勧めします。より再現性の高いテストを行えます：

{
  "mcpServers": {
    "youtube-translate": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "YOUTUBE_TRANSLATE_API_KEY",
        "youtube-translate-mcp"
      ],
      "env": {
        "YOUTUBE_TRANSLATE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

YOUR_API_KEY を実際の YouTube Translate API キーに置き換えてください。

Claude Desktop で MCP サーバーを使用する方法について詳しくは、MCP のドキュメントを参照してください。

デバッグ

• 通常の MCP Inspector には MCP ツールの呼び出しに対するタイムアウトが組み込まれていますが、動画処理の呼び出しには一般に短すぎます（2025 年 3 月 13 日時点）。代わりに Claude Desktop を使用し、Claude の MCP ログ（~/Library/Logs/Claude/mcp-server-{asfasf}.log）を確認してください。
• Claude を操作しながらログを追跡するには、tail -f {log-file}.log を実行できます。

ライセンス

MIT