使用说明

项目简介

YouTube MCP服务器是一个应用后端，它实现了 Model Context Protocol (MCP)，旨在为大型语言模型 (LLM) 客户端提供访问和处理 YouTube 视频内容的能力。通过此服务器，LLM 可以搜索 YouTube 视频，获取视频的文字转录，并将视频信息存储以进行语义搜索。这使得 LLM 能够更好地理解和利用 YouTube 平台上的海量视频资源。

主要功能点

YouTube 视频搜索: 通过关键词搜索 YouTube 视频，无需使用官方 API。
视频转录: 获取指定 YouTube 视频的文字转录内容。
视频信息存储: 将视频信息和转录内容存储到向量数据库中，以便进行高效的语义搜索。
语义搜索: 在已存储的视频转录内容上执行语义搜索，快速找到相关视频片段。

安装步骤

克隆仓库

git clone https://github.com/IA-Programming/Youtube-MCP.git
cd Youtube-MCP

创建并激活虚拟环境 (推荐使用 uv 包管理器，仓库文档推荐使用uv，速度更快)

uv venv
# Windows 系统激活虚拟环境
.venv\Scripts\activate
# macOS/Linux 系统激活虚拟环境
source .venv/bin/activate

安装依赖

uv pip install -r requirements.txt

配置 Google API 密钥

在 '.env' 文件中添加您的 Google API 密钥，用于 embeddings 功能。

GOOGLE_API_KEY=your_api_key_here  # 替换为您的 Google API 密钥

服务器配置

要将此 MCP 服务器与 MCP 客户端（如 Claude Desktop App）配合使用，您需要在客户端中配置服务器信息。以下是 Claude App 的 'mcpServers' 配置示例，请根据您的项目路径进行调整：

{
  "mcpServers": {
    "youtube": {  // 服务器名称，可以自定义
      "command": "uv",  // 启动服务器的命令，这里使用 uv 包管理器
      "args": ["--directory", "C:\\Path\\To\\Your\\Project", "run", "server.py"], // 命令参数，指向项目目录和 server.py 文件。请将 "C:\\Path\\To\\Your\\Project" 替换为您的项目实际路径，注意使用双反斜杠或单斜杠
      "env": {
        "GOOGLE_API_KEY": "your_api_key_here" // 环境变量，用于传递 Google API 密钥。请将 "your_api_key_here" 替换为您的 Google API 密钥，或确保您的系统环境变量中已设置
      }
    }
  }
}

注意:

请将 '"C:\Path\To\Your\Project"' 替换为您的 'Youtube-MCP' 项目的实际本地路径。
请将 '"your_api_key_here"' 替换为您的 Google API 密钥，或者确保您的系统环境变量中已经设置了 'GOOGLE_API_KEY'。

如果您不使用 'uv' 包管理器，可以直接使用 Python 解释器启动，例如：

{
  "mcpServers": {
    "youtube": {
      "command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe", // Python 解释器路径，请根据您的虚拟环境调整
      "args": ["C:\\Path\\To\\Your\\Project\\server.py"], // server.py 脚本路径，请根据您的项目实际路径调整
      "env": {
        "GOOGLE_API_KEY": "your_api_key_here"
      }
    }
  }
}

基本使用方法

启动服务器: 根据 "运行服务器" 章节的说明，选择 "直接方法" 或 "配置 Claude.app" 的方式启动 'server.py'。推荐使用 "直接方法" 在终端中启动服务器进行测试。
```
uv run python server.py
```
启动成功后，服务器将在后台运行并监听 MCP 客户端的请求。
配置 MCP 客户端: 打开您的 MCP 客户端（如 Claude Desktop App），按照客户端的指引配置 MCP 服务器。将上面提供的 'mcpServers' 配置添加到客户端的设置中。
使用工具: 在 MCP 客户端中，您应该能够看到 YouTube MCP 服务器提供的工具（通常在客户端的工具或插件列表中显示）。您可以使用自然语言指令调用这些工具，例如：
- "搜索关于 Python 教程的 YouTube 视频"
- "获取这个 YouTube 视频的转录：[视频链接]"
- "在存储的视频转录中搜索关于机器学习的内容"
客户端会将您的指令转换为对 MCP 服务器工具的调用，服务器执行相应的操作后，将结果返回给客户端。

关键词