YouTube Translate MCP

这是一个用于访问 YouTube Translate API 的 Model Context Protocol (MCP) 服务器，允许您获取 YouTube 视频的字幕、翻译和摘要。

功能

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

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 youtube-translate-mcp：

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

手动安装

此包需要 Python 3.12 或更高版本：

bash

使用 uv（推荐）

uv pip install youtube-translate-mcp

使用 pip

pip install youtube-translate-mcp

或者从源代码安装：

bash

克隆仓库

git clone https://github.com/yourusername/youtube-translate-mcp.git
cd youtube-translate-mcp

使用 uv（推荐）

uv pip install -e .

使用 pip

pip install -e .

使用

运行服务器：

bash

使用 stdio 传输（默认）

YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp

使用 SSE 传输

YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp --transport sse --port 8000

Docker

您也可以使用 Docker 运行服务器：

bash

构建 Docker 镜像

docker build -t youtube-translate-mcp .

使用 stdio 传输运行

docker run -e YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp

使用 SSE 传输运行

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（可选）

设置

bash

使用 uv 创建并激活虚拟环境（推荐）

uv venv
source .venv/bin/activate # 在 Windows 上：.venvScriptsactivate

使用 uv 安装依赖项

uv pip install -e .

或者，使用标准工具

python -m venv .venv
source .venv/bin/activate # 在 Windows 上：.venvScriptsactivate
pip install -e .

使用 Claude Desktop 测试

要在 Claude Desktop（仅限 macOS/Windows）上测试，您需要将您的服务器添加到位于 ~/Library/Application Support/Claude/claude_desktop_config.json 的 Claude Desktop 配置文件中。

方法 1：本地开发

如果您想测试本地开发版本，请使用此方法：

json
{
"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 进行测试（推荐用于更可重现的测试）：

json
{
"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 密钥。

有关使用 MCP 服务器与 Claude Desktop 的更多信息，请参阅 MCP 文档。

调试

• 通常的 MCP 检查器对 MCP 工具调用有一个内置的超时时间，这对于视频处理调用来说通常太短（截至2025年3月13日）。最好使用 Claude Desktop 并查看 Claude 中的 MCP 日志文件 ~/Library/Logs/Claude/mcp-server-{asfasf}.log。
• 可以使用 tail -f {log-file}.log 命令在与 Claude 交互时实时查看日志。

许可证

MIT