YouTube Ultimate Toolkit MCP

一个强大的模型上下文协议（MCP）服务器，使Claude AI能够完全访问YouTube内容——转录本、元数据、评论、屏幕截图和音频片段。

适用于Claude Desktop（本地）和Claude Web UI（使用OAuth远程）。

演示

Demo

观看完整演示视频（MP4）

为什么选择MCP？

特性

快速开始

选项1：本地模式（克劳德桌面）

# Install
git clone https://github.com/Comzee/Youtube-Ultimate-Toolkit-MCP.git
cd Youtube-Ultimate-Toolkit-MCP
npm install
npm run build

# Run
node dist/index.js

添加到Claude桌面配置(~/.config/claude/claude_desktop_config.json 在Linux上， ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["/path/to/Youtube-Ultimate-Toolkit-MCP/dist/index.js"]
    }
  }
}

选项2：远程模式（Claude Web UI）

远程模式需要OAuth设置和公共URL。请参阅 远程模式设置 在......下面

先决条件

• Node.js 18+
• yt-dlp -YouTube内容提取器（必须保持更新）
• FFmpeg -用于截图和音频提取（可选）
• YouTube API密钥 -仅用于评论功能（可选）

安装先决条件

Ubuntu/Debian：

# Node.js 18+
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# yt-dlp (keep updated - YouTube breaks old versions frequently)
pip3 install --upgrade yt-dlp

# ffmpeg (for screenshots and audio)
sudo apt install ffmpeg

macOS：

brew install node yt-dlp ffmpeg

窗户：

# Install Node.js from https://nodejs.org
# Install yt-dlp: pip install yt-dlp
# Install ffmpeg from https://ffmpeg.org/download.html

保持yt-dlp更新

YouTube经常更改其API。如果成绩单停止工作，请更新yt-dlp：

pip3 install --upgrade yt-dlp
# or on systems that complain about externally-managed packages:
pip3 install --upgrade --break-system-packages yt-dlp

安装

git clone https://github.com/Comzee/Youtube-Ultimate-Toolkit-MCP.git
cd Youtube-Ultimate-Toolkit-MCP
npm install
npm run build

远程模式设置

远程模式允许您通过HTTPS和OAuth身份验证将此MCP与Claude Web UI（Claude.ai）一起使用。

1.配置环境

cp .env.example .env

编辑 .env:

# OAuth credentials
OAUTH_CLIENT_ID=youtube-mcp-client
OAUTH_CLIENT_SECRET=your-secret-here  # Generate: openssl rand -hex 32

# Password for the consent page (bcrypt hash)
# Generate: node -e "require('bcrypt').hash('your-password', 12).then(console.log)"
AUTH_PASSWORD_HASH=$2b$12$...your-hash-here...

# Optional: YouTube API key for get_comments tool
YOUTUBE_API_KEY=your-api-key-here

2.启动服务器

# Development
npm run start:remote

# Production (with systemd)
sudo cp youtube-mcp.service /etc/systemd/system/
# Edit the service file to set your username and paths
sudo nano /etc/systemd/system/youtube-mcp.service
sudo systemctl daemon-reload
sudo systemctl enable youtube-mcp
sudo systemctl start youtube-mcp

3.设置HTTPS（必填）

Claude Web UI需要HTTPS。使用nginx作为反向代理：

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass http://localhost:3010;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket support
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # Important for long-running requests
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 86400s;
        proxy_send_timeout 86400s;
        proxy_set_header X-Accel-Buffering no;
    }
}

4.连接Claude Web用户界面

1. 首选 设置 → 连接器 → 添加自定义连接器
2. 输入URL: https://your-domain.com/mcp
3. 开始新的聊天并启用MCP
4. 让Claude获取YouTube视频-将出现授权弹出窗口
5. 在同意页面上输入密码，然后单击“授权”

工具参考

获取_视频

获取视频元数据和英文成绩单。

参数：

支持的URL格式：

• youtube.com/watch?v=VIDEO_ID
• youtu.be/VIDEO_ID
• youtube.com/shorts/VIDEO_ID
• youtube.com/live/VIDEO_ID
• youtube.com/embed/VIDEO_ID
• m.youtube.com/watch?v=VIDEO_ID
• music.youtube.com/watch?v=VIDEO_ID
• 直接视频ID: dQw4w9WgXcQ

get_playlist

在YouTube播放列表中列出视频。

参数：

获取_注释

从视频中获取热门评论。 需要 YOUTUBE_API_KEY 在.env中。

参数：

get_creenshot

从视频中捕获一帧。 需要ffmpeg。

参数：

退货： Base64编码的JPEG图像

获取音频

提取音频片段进行分析。 需要ffmpeg。

参数：

退货： Base64编码MP3音频（128kbps）

OAuth和安全

远程模式使用PKCE实现OAuth 2.1以进行安全身份验证。

运作原理

1. 克劳德连接到 /mcp -发现/握手方法无需身份验证即可工作
2. 当您使用工具时，Claude会收到一个401，其中包含OAuth发现信息
3. Claude执行动态客户端注册
4. 浏览器打开同意页面-您输入密码
5. Claude将身份验证码交换为访问令牌
6. 后续请求使用Bearer令牌

安全特性

故障排除

“没有可用的英语成绩单”

更新yt-dlp-YouTube经常更改：

pip3 install --upgrade yt-dlp

MCP无法从Claude Web UI连接

• 确保HTTPS配置正确
• 检查服务状态： sudo systemctl status youtube-mcp
• 检查日志： sudo journalctl -u youtube-mcp -f

OAuth流未启动

• 验证 .well-known/ 端点返回200（不是401）
• 检查浏览器控制台是否存在CORS错误
• 确保 /register 返回有效凭据

授权窗口未出现

• OAuth首先触发 工具使用，未连接
• 开始聊天，启用MCP，然后让Claude获取YouTube视频

克劳德使用了错误/旧的工具

在Claude设置中断开并重新连接MCP以刷新工具列表。

克劳德项目提示

在Claude项目中使用此提示自动利用MCP：

You have access to the YouTube MCP server. When I share a YouTube URL:
1. Automatically fetch the transcript with get_video
2. Provide a summary, key takeaways, and notable quotes
3. For long videos (10+ min), consider using keySegmentsOnly=true first

Available tools:
- get_video: Transcript and metadata (supports timestamps, time ranges, search)
- get_playlist: List videos in a playlist
- get_comments: Top comments (requires API key)
- get_screenshot: Capture frames at any timestamp
- get_audio: Extract audio clips for analysis (max 120s)

建筑

• 运输： 可流式HTTP（MCP规范2025-03-26）
• 会议： 具有UUID标识符的状态（内存中）
• OAuth： 授权码+PKCE，动态客户端注册
• 代币： 内存存储（重启时丢失）

许可证

麻省理工学院-参见 许可证 了解详情。

贡献

欢迎投稿！请在GitHub上打开问题或PR。