YouTube MCP Server

基本能力

产品定位

YouTube MCP Server 是一个专门用于处理YouTube视频内容的服务，提供视频搜索、字幕获取和语义搜索功能。

核心功能

• 无需使用官方API即可搜索YouTube视频
• 获取视频字幕
• 将视频信息和字幕存储在向量数据库中
• 对存储的视频字幕进行语义搜索

适用场景

• 教育领域：搜索和获取教学视频的字幕
• 研究领域：对视频内容进行语义搜索和分析
• 内容创作：快速查找相关视频内容

工具列表

1. search-youtube: 根据查询字符串搜索YouTube视频
2. 参数: query（搜索字符串）, max_results（返回结果的最大数量，默认为5）
3. get-transcript: 获取YouTube视频的字幕
4. 参数: video_url（YouTube视频的URL）
5. store-video-info: 将视频信息和字幕存储在向量数据库中
6. 参数: video_url（YouTube视频的URL）, metadata（可选的视频元数据）
7. search-transcripts: 使用语义搜索存储的视频字幕
8. 参数: query（搜索查询）, limit（返回结果的最大数量，默认为3）

常见问题解答

• 确保Google API密钥正确设置在.env文件中
• 检查所有依赖是否正确安装
• 验证服务器是否正在运行并监听连接
• 查看服务器输出中的任何错误消息

使用教程

使用依赖

• Python 3.8+
• Google API密钥用于嵌入
• uv包管理器

安装教程

1. 克隆仓库
2. 创建并激活虚拟环境:

uv venv
# Windows:
.venv\Scripts\activate
# Unix/MacOS:
source .venv/bin/activate

1. 安装依赖:

uv pip install -r requirements.txt

1. 创建.env文件并添加Google API密钥:

GOOGLE_API_KEY=your_api_key_here

调试方式

1. 直接运行服务器:

uv run python server.py

1. 配置Claude.app:

"mcpServers": {
  "youtube": {
    "command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
    "args": ["C:\\Path\\To\\Your\\Project\\server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

或使用uv包管理器:

"mcpServers": {
  "youtube": {
    "command": "uv",
    "args": ["--directory", "C:\\Path\\To\\Your\\Project", "run", "server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。