🚀 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：本地设置
- 克隆仓库：
git clone https://github.com/Prajwal-ak-0/youtube-mcp
cd youtube-mcp
- 创建虚拟环境并安装依赖项：
python -m venv .venv
source .venv/bin/activate # 在Windows上：.venv\Scripts\activate
pip install -e .
- 创建包含API密钥的
.env文件：
GEMINI_API_KEY=your_gemini_api_key
YOUTUBE_API_KEY=your_youtube_api_key
- 运行MCP服务器
mcp dev main.py
打开Stdio进行访问
或者
- 配置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。