Y

Youtube-MCP（优兔模型上下文协议服务器）

@IA-Programming/Youtube-MCP
0 Stars 40 次浏览 IA-Programming 更新于 2026-08-23

一种模型上下文协议服务器，它能够在不使用官方YouTube API的情况下，实现搜索YouTube视频、检索和存储字幕以及对视频内容进行语义搜索的功能。

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

YouTube MCP 服务器

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

支持我们

如果您认为此项目有用，并希望支持未来的项目，请考虑给我们买杯咖啡！您的支持有助于我们继续构建创新的 AI 解决方案。

您的贡献对我们创建智能且用户友好的应用程序的热情有很大的帮助。

目录

功能

  • 不使用官方 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
  1. 使用 uv 安装依赖项：
uv pip install -r requirements.txt
  1. 创建一个包含您的 Google API 密钥的 .env 文件：
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桌面应用程序。工具将被自动发现并提供给客户端使用。

使用示例

  1. 使用上述任一方法启动服务器
  2. 打开Claude桌面应用程序
  3. 查找锤子图标以确认YouTube工具可用
  4. 现在您可以使用如下命令：
    • "搜索Python教程视频"
    • "获取该视频的文字记录：[video_url]"
    • "在存储的视频文字记录中搜索关于机器学习的内容"

调试

如果您遇到任何问题：

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

贡献

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

许可证

本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

查看源码 项目主页