YouTube视频摘要生成器

一个通过获取YouTube视频字幕并生成可定制摘要的MCP服务器工具。

  • by 5hivanand
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 5hivanand/mcp-youtube-video-summary

使用说明

YouTube视频摘要

一种模型上下文协议(MCP)服务器,用于获取YouTube视频转录并生成可定制的摘要。

特性

  • 视频ID提取:从各种URL格式(YouTube.com、youtu.be等)提取YouTube视频ID
  • 获取成绩单:使用YouTube转录API获取视频转录
  • 缓存:在本地缓存转录,以便更快地检索
  • 可定制的提示:生成多种格式的摘要:
    • 快速30秒总结
    • 详细的2-3分钟总结
    • markdown格式的结构化笔记

安装

需求

  • Python>=3.12
  • uv 包管理器(可选,但推荐)

设置

  1. 克隆存储库:
git clone <repository-url>
cd mcp-youtube-video-summary
  1. 安装依赖项:
# Using uv
uv sync

# Or using pip
pip install -r requirements.txt

用法

运行MCP服务器

uv run main.py

服务器将从MCP通信的标准I/O传输开始。

可用工具

  • get_youtube_video_transcript(url: str):获取给定YouTube URL的文字记录

可用提示

  • quick_summary_prompt(video_url: str):快速生成30秒摘要
  • detailed_summary_prompt(video_url: str):生成详细的2-3分钟摘要
  • structured_notes_prompt(video_url: str):生成全面的结构化笔记

与AI客户端集成

克劳德桌面

  1. 打开 ~/Library/Application Support/Claude/claude_desktop_config.json
  2. 添加以下配置:
{
  "mcpServers": {
    "Youtube-Video-Summary": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/Shiva/Developer/mcp/mcp-youtube-video-summary",
        "run",
        "main.py"
      ]
    }
  }
}
  1. 重新启动克劳德桌面

VS Code

  1. 安装VS Code的MCP扩展
  2. 将服务器配置添加到VS代码设置中:
{
  "mcp.servers": {
    "Youtube-Video-Summary": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/Shiva/Developer/mcp/mcp-youtube-video-summary",
        "run",
        "main.py"
      ]
    }
  }
}

项目结构

.
├── main.py                          # MCP server entry point
├── prompts.yaml                     # Prompt templates
├── pyproject.toml                   # Project configuration
├── youtube_transcript/
│   ├── __init__.py                 # Package exports
│   ├── video_id.py                 # Video ID extraction
│   ├── transcript.py               # Transcript fetching
│   └── cache.py                    # Local caching
└── README.md                        # This file

配置

编辑 prompts.yaml 为不同的用例定制摘要提示。

依赖项

  • fastmcp:模型上下文协议框架
  • youtube转录api:获取YouTube成绩单
  • 格式:YAML配置解析

许可证

麻省理工学院

贡献

请随时提交问题和增强请求!