YouTube Vision MCP 服务器 ( youtube-vision )
MCP(模型上下文协议)服务器利用 Google Gemini Vision API 与 YouTube 视频进行交互。它允许用户获取 YouTube 视频的描述、摘要、问题答案以及提取关键时刻。
特征
使用 Gemini Vision API 分析 YouTube 视频。
为不同的交互提供多种工具:
一般说明或问答 (
ask_about_youtube_video)摘要(
summarize_youtube_video)关键时刻提取(
extract_key_moments)
列出支持
generateContent可用 Gemini 模型。可通过环境变量配置 Gemini 模型。
通过 stdio(标准输入/输出)进行通信。
Related MCP server: Google Search MCP Server
先决条件
在使用此服务器之前,请确保您具有以下条件:
**Node.js:**建议使用 18 或更高版本。您可以从nodejs.org下载。
**Google Gemini API 密钥:**从Google AI Studio或 Google Cloud Console 获取您的 API 密钥。
安装和使用
使用此服务器主要有两种方式:
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 youtube-vision-mcp:
选项 1:使用 npx(推荐快速使用)
运行此服务器的最简单方法是使用npx ,它可以下载并运行包而无需永久安装。
您可以在 MCP 客户端的设置文件(Claude、VSCode ..)中对其进行配置:
用您的实际 Google Gemini API 密钥替换"YOUR_GEMINI_API_KEY" 。
选项 2:手动安装(从源代码)
如果您想修改代码或直接从源代码运行它:
克隆存储库:
git clone https://github.com/minbang930/Youtube-Vision-MCP.git cd youtube-vision安装依赖项:
npm install构建项目:
npm run build**配置并运行:**您可以直接使用
node dist/index.js运行编译后的代码(确保GEMINI_API_KEY已设置为环境变量),或者配置您的 MCP 客户端使用node命令和dist/index.js的绝对路径来运行它,并通过env设置传递 API 密钥,如 npx 示例中所示。
配置
服务器使用以下环境变量:
GEMINI_API_KEY(必需):您的 Google Gemini API 密钥。GEMINI_MODEL_NAME(可选):要使用的具体 Gemini 模型(例如gemini-1.5-flash)。默认为gemini-2.0-flash。**重要提示:**对于生产或商业用途,请确保选择未标记为“实验”或“预览”的模型版本。
环境变量应在 MCP 客户端设置文件 (例如mcp_settings.json ) 的env部分中设置。
可用工具
1. ask_about_youtube_video
回答有关视频的问题,或者如果没有问题则提供一般描述。
输入:
youtube_url(字符串,必需):YouTube 视频的 URL。question(字符串,可选):关于视频的具体问题。如果省略,则生成一般描述。
**输出:**包含答案或描述的文本。
2. summarize_youtube_video
生成给定 YouTube 视频的摘要。
输入:
youtube_url(字符串,必需):YouTube 视频的 URL。summary_length(字符串,可选):所需的摘要长度(“短”、“中”、“长”)。默认为“中”。
**输出:**包含视频摘要的文本。
3. extract_key_moments
从给定的 YouTube 视频中提取关键时刻(时间戳和描述)。
输入:
youtube_url(字符串,必需):YouTube 视频的 URL。number_of_moments(整数,可选):要提取的关键时刻数量。默认为 3。
**输出:**带有时间戳的描述关键时刻的文本。
4. list_supported_models
列出支持generateContent方法(通过 REST API 获取)的可用 Gemini 模型。
**输入:**无
**输出:**列出支持的模型名称的文本。
重要提示
**生产模型选择:**将此服务器用于生产或商业用途时,请确保所选的
GEMINI_MODEL_NAME是适合生产使用的稳定版本。根据Gemini API 服务条款,标记为“实验”或“预览”的模型不允许用于生产部署。**API 服务条款:**此服务器的使用依赖于 Google Gemini API。用户有责任查看并遵守Google API 服务条款和Gemini API 附加服务条款。请注意,Gemini API 的免费版和付费版的数据使用政策可能有所不同。使用免费版时,请勿提交敏感或机密信息。
内容责任: Gemini API 生成的内容的准确性和适当性无法得到保证。请谨慎信赖或发布生成的内容。
执照
本项目遵循 MIT 许可证。详情请参阅 LICENSE 文件。