YouTube Transcript MCP Server 使用说明

项目简介

YouTube Transcript MCP Server 是一个基于 Model Context Protocol (MCP) 实现的服务器，专注于为LLM应用提供YouTube视频的字幕内容。它通过实现 MCP 协议，将 YouTube 字幕提取功能以标准化的工具形式暴露给任何兼容 MCP 协议的客户端，使得 LLM 可以轻松获取视频文本信息，扩展其上下文理解能力。

主要功能点

YouTube 字幕下载: 支持通过 YouTube 视频链接或视频 ID 下载视频字幕。
多种字幕格式: 提供带时间戳和不带时间戳两种字幕格式，满足不同 LLM 应用的需求。
多语言支持: 支持指定字幕语言，默认为英语，并能自动选择可用字幕。
MCP 工具集成: 以 MCP 工具的形式提供字幕提取功能，方便 LLM 客户端调用。

安装步骤

克隆仓库

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

创建并激活虚拟环境 (推荐使用 uv 进行包管理)

uv venv
source .venv/bin/activate   # Linux / macOS
# .venv\Scripts\activate  # Windows

安装依赖
```
uv sync
```
运行服务器
```
python -m youtube_mcp
```
服务器默认使用标准输入/输出 (stdio) 进行通信。

服务器配置

为了让 MCP 客户端连接到 YouTube Transcript MCP Server，需要在客户端的配置文件中添加服务器信息。以下是一个配置示例，展示了如何使用 'uvx' 命令直接从 GitHub 仓库启动服务器：

"mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/adhikasp/mcp-youtube", "mcp-youtube"]
    }
}

'server name': '"youtube"' (服务器名称，客户端用于识别和引用此服务器，可以自定义)
'command': '"uvx"' (启动服务器的命令，这里使用 'uvx' 直接从 git 仓库运行)
'args': '["--from", "git+https://github.com/adhikasp/mcp-youtube", "mcp-youtube"]' (传递给 'uvx' 的参数，指定从 GitHub 仓库安装并运行 'mcp-youtube' 包)

基本使用方法

配置完成后，在 MCP 客户端中，你可以通过调用名为 'youtube-transcript' 的工具来获取 YouTube 视频字幕。

工具 'youtube-transcript' 接受以下参数：

'video_url': YouTube 视频的 URL 或视频 ID。
'with_timestamps' (可选): 布尔值，指示是否包含时间戳，默认为 'false'。
'language' (可选): 字幕语言代码，默认为 '"en"' (英语)。

客户端发送工具调用请求后，服务器会返回包含视频字幕的文本内容，LLM 应用即可利用这些字幕信息进行后续处理，例如问答、摘要、情感分析等。

关键词