YouTube转录MCP服务器
一个模型上下文协议(MCP)服务器,使AI编码助手(Claude、Cursor、Windsurf等)能够分析YouTube视频转录。该服务器使用Gemini API处理YouTube视频并提取他们的成绩单回答问题,使您的人工智能助手可以访问视频内容进行分析、总结和学习。
特性
🤖 多客户端支持:适用于Claude Code、Cursor、Windsurf和其他MCP兼容客户端
- 🌍 交叉平台的:适用于Windows、macOS和Linux的安装程序
- 🚀 简易安装:自动检测和配置AI客户端的通用安装程序
先决条件
- Python 3.x -安装人员将检查并提供安装说明(如果缺失)
- Gemini API密钥 从 谷歌人工智能工作室
- 至少安装了一个受支持的AI助手:
- 克劳德代码 - 光标 - 帆板运动 - Gemini CLI
安装程序将自动检查所有依赖关系,如果缺少任何内容,将提供特定于平台的安装说明。
安装
选项1:Git免费快速安装(推荐)
这些安装程序直接下载服务器,不需要git:
macOS/Linux/WSL
卷曲
curl -sSL https://raw.githubusercontent.com/boxabirds/yt-gemini-mcp/main/install-mcp-universal-no-git.sh | bashwget
wget -qO- https://raw.githubusercontent.com/boxabirds/yt-gemini-mcp/main/install-mcp-universal-no-git.sh | bashWindows(PowerShell)
# Quick install
iwr -useb https://raw.githubusercontent.com/boxabirds/yt-gemini-mcp/main/install-mcp-universal-no-git.ps1 | iexWindows(命令提示符)
为了获得最简单的体验,请下载以下两个文件:
# Download the PowerShell installer and its wrapper
curl -O https://raw.githubusercontent.com/boxabirds/yt-gemini-mcp/main/install-mcp-universal-no-git.ps1
curl -O https://raw.githubusercontent.com/boxabirds/yt-gemini-mcp/main/install-mcp-universal-no-git.cmd
# Run the installer
install-mcp-universal-no-git.cmd或者直接使用PowerShell,如上所示。
选项2:GitHub Gist安装
您还可以将这些脚本作为GitHub Gists共享:
# Unix/Linux/macOS
curl -sSL https://gist.github.com/YOUR_USERNAME/GIST_ID/raw/install-mcp-universal-no-git.sh | bash
# Windows
iwr -useb https://gist.github.com/YOUR_USERNAME/GIST_ID/raw/install-mcp-universal-no-git.ps1 | iex选项3:使用Git手动安装
如果您更喜欢克隆存储库:
macOS/Linux
# Clone and run the installer
git clone https://github.com/your-username/yt-gemini-mcp.git
cd yt-gemini-mcp
chmod +x install-mcp-universal.sh
./install-mcp-universal.sh视窗
# Clone and run the installer
git clone https://github.com/your-username/yt-gemini-mcp.git
cd yt-gemini-mcp
install-mcp-universal.cmd安装程序做什么
- 检查依赖关系:验证Python、jq(Unix/Linux/macOS)和其他要求
- 下载MCP服务器:获取YouTube转录服务器(如果使用git免费安装程序)
- 检测AI助手:自动查找已安装的客户端(Claude、Cursor、Windsurf、Gemini CLI)
- 配置每个客户端:为每个检测到的助手设置服务器
- 管理API密钥:请求Gemini API密钥一次,并将其安全存储以供重复使用
- 安装Python包:设置所需的依赖关系(mcp、fastmcp、谷歌genai)
用法
安装后,服务器将在您的AI助手中可用 ask-youtube.
克劳德密码
Can you analyze this YouTube video about Python async programming?
https://www.youtube.com/watch?v=example123Claude将自动使用ask youtube服务器来获取和分析视频内容。
测试安装
安装后,您可以测试服务器:
macOS
~/Library/Application\ Support/YouTube-Transcript-MCP/test-server.shLinux
~/.mcp-installer/test-server.sh视窗
%LOCALAPPDATA%\.mcp-installer\test-server.cmd文件位置
安装程序在以下位置创建文件:
- 服务器文件:
- macOS: ~/Library/Application Support/YouTube-Transcript-MCP/servers/ - Linux: ~/.mcp-installer/servers/ - 窗户: %LOCALAPPDATA%\.mcp-installer\servers\
- 虚拟环境:
- macOS: ~/Library/Application Support/YouTube-Transcript-MCP/venv/ - Linux: ~/.mcp-installer/venv/ - 窗户: %LOCALAPPDATA%\.mcp-installer\venv\
- 客户端配置:
- 克劳德代码:管理者 claude mcp add 命令 - 光标: ~/.cursor/mcp.json 或 %USERPROFILE%\.cursor\mcp.json - Windsurf:平台特定位置 - Gemini CLI: ~/.gemini/settings.json 或 %USERPROFILE%\.gemini\settings.json
安装程序功能
- 无需Git:git免费安装程序直接通过HTTPS下载文件
- 独立:没有外部依赖关系的单个脚本
- 多客户端支持:自动配置所有检测到的AI助手
- 回退URL:如果主下载失败,尝试多个CDN源
- 安全:使用受限文件权限存储的API密钥
- 交叉平台的:适用于Windows、macOS和Linux
故障排除
“未检测到受支持的AI助手”
确保您至少安装了一个受支持的客户端,并且它在您的系统PATH中(用于Claude Code等命令行工具)。
“缺少必需的依赖项”
安装错误消息中显示的缺少的依赖项。安装程序提供特定于平台的安装命令。
找不到jq(Unix/Linux/macOS):
# macOS
brew install jq
# Ubuntu/Debian
sudo apt-get install jq
# RHEL/CentOS
sudo yum install jq找不到Python:
- 下载自https://python.org/downloads/
- 确保在安装过程中将Python添加到PATH中
“API密钥不能为空”
您必须提供有效的Gemini API密钥。从以下位置获取一个 谷歌人工智能工作室.
下载失败
安装程序尝试多个来源:
- GitHub原始内容
- jsDelivr CDN
- GitCDN
如果全部失败,您可能需要:
- 检查您的互联网连接
- 验证防火墙设置
- 尝试手动下载
服务器未出现在AI助手中
- 重新启动AI助手应用程序
- 检查安装是否成功完成
- 验证配置文件是否存在于上面列出的位置
未检测到客户端
确保AI助手安装在默认位置:
- Gemini CLI:
~/.gemini/ - 克劳德代码:
claudePATH中可用的命令 - 帆板运动:标准安装目录
- 光标:
~/.cursor/或%USERPROFILE%\.cursor\
安全说明
- API密钥存储在
keys.json具有受限的文件权限(仅限所有者) - 切勿分享或承诺
keys.json文件或测试脚本,因为它们包含API密钥 - 测试脚本包含纯文本的API密钥-不要共享它们
- 考虑在生产环境中使用环境变量以提高安全性
更新中
要更新服务器,只需再次运行安装程序。它将:
- 下载最新的服务器版本
- 保留API密钥
- 更新所有客户端配置
贡献
欢迎投稿!请随时提交拉取请求。
许可证
该项目是开源的,可在 MIT许可证.
