YouTube MCP Server

YouTube MCP Server

一个模型上下文协议（MCP）服务，提供搜索 YouTube 视频、获取字幕以及对视频内容进行语义搜索的工具。

支持我们

如果你觉得这个项目很有帮助，并希望支持我们未来的项目，可以考虑请我们喝杯咖啡！你的支持有助于我们继续打造创新的 AI 解决方案。

你的支持将为我们创造智能、易用的应用注入动力。

目录

• YouTube MCP Server
• 功能
• 前提条件
• 安装
• 运行服务
  • 1. 直接运行
  • 2. 为 Claude.app 配置
• 可用工具
• 与 MCP 客户端搭配使用
  • 使用示例
• 调试
• 参与贡献
• 许可证

功能

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

前提条件

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

安装

1. 克隆此仓库

2. 使用 uv 创建并激活虚拟环境：

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

3. 使用 uv 安装依赖项：

uv pip install -r requirements.txt

4. 创建 .env 文件并填入 Google API 密钥：

GOOGLE_API_KEY=your_api_key_here

运行服务

有两种方式可以运行 MCP 服务：

1. 直接运行

直接启动 MCP 服务：

uv run python server.py

2. 为 Claude.app 配置

将配置添加到 Claude 设置中，无需使用任何包管理器，此方法适用于 Windows：

"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 包管理器，此方法适用于 Windows：

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

可用工具

此服务提供以下工具：

1. search-youtube：根据查询搜索 YouTube 视频

   • 参数：
     • query：搜索查询字符串
     • max_results：返回结果的最大数量（默认值：5）

2. get-transcript：获取 YouTube 视频的字幕

   • 参数：
     • video_url：YouTube 视频的 URL

3. store-video-info：将视频信息和字幕存储在向量数据库中

   • 参数：
     • video_url：YouTube 视频的 URL
     • metadata：有关视频的可选元数据

4. search-transcripts：使用语义搜索查找已存储的视频字幕

   • 参数：
     • query：搜索查询
     • limit：返回结果的最大数量（默认值：3）

与 MCP 客户端搭配使用

此服务可与任何兼容 MCP 的客户端搭配使用，例如 Claude Desktop App。客户端会自动发现这些工具并将其提供给客户端使用。

使用示例

1. 使用上述任一方式启动服务
2. 打开 Claude Desktop App
3. 查看锤子图标，确认 YouTube 工具已可用
4. 现在可以使用以下命令：
   • “搜索 Python 教程视频”
   • “获取此视频的字幕：[video_url]”
   • “搜索已存储的机器学习相关视频字幕”

调试

如果遇到问题：

1. 确认 .env 文件中已正确设置 Google API 密钥
2. 检查是否已正确安装所有依赖项
3. 确认服务正在运行并监听连接
4. 查看服务输出中是否有错误消息

参与贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。