返回 MCP 目录
public公开dns本地运行

youtube-translate-mcp

YouTube视频翻译与摘要生成工具

article

README

🚀 YouTube 翻译 MCP 服务器

这是一个基于 模型上下文协议 (MCP) 的服务器,可用于访问 YouTube 翻译 API。它支持获取字幕、翻译内容、生成字幕文件以及创建视频总结等功能,为用户处理 YouTube 视频相关内容提供了便利。

🚀 快速开始

该服务器可帮助你轻松访问 YouTube 翻译 API,完成获取字幕、翻译、生成文件和总结视频等操作。你可以按照以下步骤进行安装和使用。

✨ 主要特性

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

📦 安装指南

使用 Smithery 安装

通过 Smithery 可自动安装 youtube-translate-mcp 以在 Claude Desktop 上运行,命令如下:

npx -y @smithery/cli install @brianshin22/youtube_translate_mcp --client claude

手动安装

此包需要 Python 3.12 或更高版本,你可以选择以下方式进行安装:

# 使用 uv(推荐)
uv pip 安装 youtube_translate_mcp

# 使用 pip
pip 安装 youtube_translate_mcp

或从源码安装:

# 克隆仓库
git clone https://github.com/yourusername/youtube_translate_mcp.git
cd youtube_translate_mcp

# 使用 uv(推荐)
uv pip 安装 -e .

# 使用 pip
pip 安装 -e .

💻 使用示例

基础用法

运行服务器,使用 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 运行服务器,步骤如下:

# 构建 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 翻译 API 的密钥。

使用 Smithery 部署

此包包含一个 smithery.yaml 文件,方便使用 Smithery 进行部署。

调试信息

  • 由于 MCP 检查工具对调用超时时间设置较短(截至 2025 年 3 月 13 日),建议使用 Claude Desktop 查看 MCP 日志,位于 ~/Library/Logs/Claude/mcp-server-{asfasf}.log
  • 可以通过执行命令 tail -f {log-file}.log 实时查看日志。

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端