YouTube MCP 服务器

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

支持我们

如果你发现这个项目对你有帮助，并希望支持未来的项目，请考虑给我们买杯咖啡！你的支持有助于我们继续构建创新的人工智能解决方案。

<a href="https://www.buymeacoffee.com/blazzmocompany"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=blazzmocompany&button_colour=40DCA5&font_colour=ffffff&font_family=Cookie&outline_colour=000000&coffee_colour=FFDD00"></a>

你的贡献对我们创造智能且用户友好的应用程序的热情有着巨大的推动作用。

目录

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

功能

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

前提条件

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

安装

1. 克隆此仓库

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

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

3. 使用uv安装依赖项：

uv pip install -r requirements.txt

4. 创建一个包含你的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. 查看服务器输出中的任何错误消息

贡献

欢迎贡献！请随时提交拉取请求。

许可证

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