🚀 YouTube MCP

一个用于YouTube视频分析的模型上下文协议（MCP）服务器，为用户提供获取字幕、总结内容和使用Gemini AI查询视频的实用工具，助力高效分析YouTube视频。

🚀 快速开始

本项目是一个用于YouTube视频分析的模型上下文协议（MCP）服务器，借助它可获取字幕、总结内容并使用Gemini AI查询视频。

✨ 主要特性

• 📝 字幕提取：从YouTube视频中获取详细的字幕
• 📊 视频摘要：利用Gemini AI生成简洁的视频摘要
• ❓ 自然语言查询：对视频内容提出问题
• 🔍 YouTube搜索：查找与特定查询匹配的视频
• 💬 评论分析：检索并分析视频评论

📦 安装指南

先决条件

• Python 3.9+
• Google Gemini API密钥
• YouTube Data API密钥

本地运行

通过Smithery安装

要自动从Claude Desktop安装youtube - mcp，请使用Smithery：

npx -y @smithery/cli install @Prajwal-ak-0/youtube-mcp --client claude

选项1：直接从smithery安装

选项2：本地设置

1. 克隆仓库：

git clone https://github.com/Prajwal-ak-0/youtube-mcp
cd youtube-mcp

2. 创建虚拟环境并安装依赖项：

python -m venv .venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
pip install -e .

3. 创建包含API密钥的.env文件：

GEMINI_API_KEY=your_gemini_api_key
YOUTUBE_API_KEY=your_youtube_api_key

4. 运行MCP服务器

mcp dev main.py

打开Stdio进行访问

或者

6. 配置Go cursor或windsurf，使用以下JSON内容：

{
  "youtube": {
    "command": "uv",
    "args": [
      "--directory",
      "/absolute/path/to/youtube-mcp",
      "run",
      "main.py",
      "--transport",
      "stdio",
      "--debug"
    ]
  }
}

💻 使用示例

基础用法

本项目提供了一系列实用工具，以下是部分工具的使用示例：

# 获取视频字幕
youtube/get-transcript 

# 生成视频摘要
youtube/summarize 

# 对视频内容进行提问
youtube/query 

# 搜索YouTube视频
youtube/search 

# 检索视频评论
youtube/get-comments 

# 获取视频点赞数
youtube/get-likes 

🔧 技术细节

本项目是一个模型上下文协议（MCP）服务器，用于YouTube视频分析。它依赖Python 3.9+环境，同时需要Google Gemini API密钥和YouTube Data API密钥。通过这些API，项目实现了字幕提取、视频摘要生成、自然语言查询、YouTube搜索以及评论分析等功能。在本地运行时，可通过Smithery自动安装，也可手动克隆仓库、创建虚拟环境、安装依赖项并配置API密钥。项目还提供了一系列可用工具，方便用户对YouTube视频进行各种操作。

📚 详细文档

可用工具

• youtube/get-transcript：获取视频字幕
• youtube/summarize：生成视频摘要
• youtube/query：对视频内容进行提问
• youtube/search：搜索YouTube视频
• youtube/get-comments：检索视频评论
• youtube/get-likes：获取视频点赞数

🤝 贡献

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