article
README
🚀 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。
扫码联系在线客服