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 
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配置解析

许可证

麻省理工学院

贡献

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