MCP 服务器

YouTube MCP Server

一个模型上下文协议服务器，无需使用官方 YouTube API 即可搜索 YouTube 视频、检索和存储视频字幕，并对视频内容执行语义搜索。

README

YouTube MCP 服务器

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

支持我们

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

您的贡献将极大地激发我们创造智能且用户友好的应用程序的热情。

特性

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

先决条件

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

安装

克隆此存储库
使用 uv 创建并激活虚拟环境：

uv venv
# 在 Windows 上：
.venv\Scripts\activate
# 在 Unix/MacOS 上：
source .venv/bin/activate

使用 uv 安装依赖项：

uv pip install -r requirements.txt

创建一个包含您的 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"
    }
  }
}

可用工具

服务器提供以下工具：

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