Youtube Translate

YouTube Translate MCP

一个用于访问 YouTube Translate API 的 Model Context Protocol (MCP) 服务，可获取 YouTube 视频的文字稿、翻译和摘要。

功能

• 获取 YouTube 视频的文字稿
• 将文字稿翻译成不同语言
• 生成 SRT 或 VTT 格式的字幕
• 创建视频内容摘要
• 搜索视频中的特定内容

托管的远程 MCP

生产环境端点：https://api.youtubetranslate.com/mcp，使用可流式传输的 HTTP。

推荐使用 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）。处理较长的视频时会返回处理提示，Agent 应稍后重试。

远程运行

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 自带的连接界面验证。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.yaml 文件，便于通过 Smithery 部署。

部署时，将配置参数 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。
• 你可以运行 tail -f {log-file}.log，在与 Claude 交互时持续查看日志。

许可证

MIT