YouTube MCP

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

功能

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

要求

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

本地运行

通过Smithery安装

要通过Smithery自动为Claude Desktop安装youtube-mcp：

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

选项1：直接安装

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服务器：

   python main.py
   

选项2：使用MCP CLI

1. 安装MCP CLI：

   pip install mcp
   

2. 在项目中创建mcp.json文件：

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

3. 使用MCP启动服务器：

   mcp run youtube
   

使用Docker

1. 构建Docker镜像：

   docker build -t youtube-mcp .
   

2. 使用您的API密钥运行容器：

   docker run -e GEMINI_API_KEY=your_gemini_api_key -e YOUTUBE_API_KEY=your_youtube_api_key youtube-mcp
   

部署到Smithery

此MCP服务器可以在Smithery上部署以便更轻松地访问：

1. 在Smithery上添加或认领您的服务器
2. 点击Smithery部署标签页中的“部署”
3. 按提示提供您的API密钥

可用工具

• youtube/get-transcript: 获取视频字幕
• youtube/summarize: 生成视频摘要
• youtube/query: 回答关于视频的问题
• youtube/search: 搜索YouTube视频
• youtube/get-comments: 检索视频评论
• youtube/get-likes: 获取视频点赞数

贡献

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