MCP Try

YouTube视频摘要生成器MCP服务器

MCP（模型上下文协议）服务器，提供与YouTube视频交互的工具。使用谷歌的Gemini Flash Lite模型获取成绩单、元数据、搜索视频、获取评论、频道统计数据和总结视频。

特性

第一阶段（核心工具）

• get_transcript -通过URL/ID获取视频转录
• 获取_视频_信息 -获取基本视频元数据（标题、频道、持续时间、观看次数、描述）
• 摘要_视频 -使用Gemini Flash Lite总结视频

第二阶段（扩展工具）

• 搜索_视频 -按关键字搜索YouTube
• 获取_注释 -从视频中获取热门评论
• get_channel_stats -获取频道统计数据（订阅者、视频计数等）

主要优势

• 无需YouTube API密钥 -使用公共抓取方法(youtube-transcript-api 和 yt-dlp)
• 只需Gemini API密钥 -仅摘要功能需要
• 快速可靠 -使用高效的抓取库

先决条件

• Python 3.8或更高版本
• uv 包管理器（推荐）或 pip
• Gemini API密钥（仅当您想要使用摘要时）

安装

1. 使用安装依赖项 uv （推荐）：

   uv add "mcp[cli]"
   uv add youtube-transcript-api
   uv add yt-dlp
   uv add google-generativeai
   uv add python-dotenv

或使用 pip:

   pip install -r requirements.txt

1. 获取Gemini API密钥（可选，仅用于摘要）：

- 访问 谷歌人工智能工作室 - 创建新的API密钥 - 复制密钥

1. 设置环境变量：

- 复制 .env.example 到 .env - 添加您的Gemini API密钥：

     GEMINI_API_KEY=your_actual_api_key_here

Claude桌面配置

1. 打开克劳德桌面配置：

- 首选 File -> Settings -> Developer -> Edit Config - 这将打开 claude_desktop_config.json

1. 添加MCP服务器配置：

- 从以下位置复制配置 claude_desktop_config.json.example - 更新路径以匹配您的系统： - 替换 YOUR_USERNAME 使用您的实际用户名 - 替换 /path/to/mcp-try 这个项目的实际路径 - 更新 uv 命令路径（如果需要）（通常 ~/.local/bin/uv 在macOS/Linux上）

1. 配置示例：

   {
     "mcpServers": {
       "YouTube Summarizer": {
         "command": "/Users/YOUR_USERNAME/.local/bin/uv",
         "args": [
           "run",
           "--with",
           "mcp[cli]",
           "mcp",
           "run",
           "/path/to/mcp-try/main.py"
         ]
       }
     }
   }

1. 重新启动克劳德桌面 使更改生效

使用示例

配置后，您可以要求Claude Desktop：

• “获取成绩单https://www.youtube.com/watch?v=VIDEO_ID"
• “总结此视频：https://www.youtube.com/watch?v=VIDEO_ID"
• “搜索有关Python编程的视频”
• “获取此视频的评论：https://www.youtube.com/watch?v=VIDEO_ID"
• “获取@channelname的频道统计信息”

工具详细信息

get_transcript

获取带有可选时间戳的视频转录。适用于任何YouTube视频URL格式或直接视频ID。

获取_视频_信息

返回全面的视频元数据，包括标题、频道、持续时间、观看次数、上传日期和描述。

摘要_视频

获取成绩单并使用Gemini Flash Lite生成摘要。支持“短”、“中”或“长”摘要长度。

搜索_视频

搜索YouTube并返回包含元数据的视频列表。默认返回前10个结果。

获取_注释

从视频中获取热门评论，按赞数排序。默认返回前10条评论。

get_channel_stats

返回频道统计信息，包括订户计数、视频计数和频道描述。

故障排除

“GEMINI_API_KEY未设置”错误

• 仅影响 summarize_video 工具
• 其他工具在没有API密钥的情况下工作
• 设置密钥 .env 文件或环境变量

“未找到成绩单”错误

• 有些视频没有可用的转录本
• 尝试其他视频或检查是否启用了字幕

“获取视频信息时出错”错误

• YouTube可能是限速请求
• 请稍候几分钟，然后重试
• 您所在地区可能无法播放某些视频

备注

• 该工具使用网络抓取方法，因此不需要YouTube API密钥
• 如果快速发出许多请求，则可能适用速率限制
• 某些视频可能没有可用的转录本
• 频道统计数据的准确性可能因隐私设置而异

许可证

本项目按原样提供，供教育和个人使用。