You Tube MCP Server Enhanced

MCP音视频

提供方 labeveryday

音视频 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

一个基于yt-dlp的YouTube数据提取和分析的微对话处理器(MCP)服务器,支持视频、频道、播放列表、评论和字幕的全面数据提取与分析。

一句话选型结论

按资料字段整理

You Tube MCP Server Enhanced 属于音视频类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式支持远程部署
GitHub 星标 5 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

YouTube数据分析Python本地部署视频内容提取频道分析评论处理字幕提取批量处理

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install uv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
You Tube MCP Server Enhanced当前 未标注 stdio · 本地进程 支持远程部署 有 2026-05-17
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方labeveryday上游标注的维护方 labeveryday
分类音视频本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.0 KB
来自项目仓库与上游目录的原文,未做删改

YouTube MCP服务器增强🚀

一个全面的微会话处理器(MCP)服务器,用于提取和分析YouTube数据 yt-dlp.

🚀 特性

岩心提取

  • 视频信息:元数据、统计数据、参与度指标
  • 频道信息:统计数据、订阅者计数、查看计数、验证状态
  • 播放列表详细信息:视频列表、持续时间、总观看次数
  • 评论:附带回复和参与的多线程评论
  • 文字记录:自动生成和手动字幕

高性能

  • YouTube搜索:搜索视频、频道和播放列表
  • 热门视频:按地区获取热门内容
  • 批处理:同时从多个URL中提取
  • 智能高速缓存:可配置的基于TTL的缓存
  • 自动检索:失败请求的指数回退
  • 健康监测:实时提取器状态和配置

🛠️ 安装

先决条件

  • Python 3.10+
  • 紫外线 包管理器 (必填)
  • yt-dlp (通过紫外线自动安装)

⚠️ 重要提示:此项目需要 uv 正确运行。先安装:```bash

Install uv (macOS/Linux)

curl -LsSf https://astral.sh/uv/install.sh | sh

Or via Homebrew (macOS)

brew install uv

Or via pip

pip install uv


### 设置```bash
# Clone the repository
git clone
cd youtube-mcp-server-enhanced

# Install yt-dlp and all dependencies
uv add yt-dlp
uv sync

# Verify installation
uv run yt-dlp --version

⚙️ 配置

环境变量(.env文件)

创建一个 .env 项目根目录中的文件以配置服务器:```bash

Copy the example file

cp .env.example .env

Edit with your preferred settings

nano .env


示例 `.env` 配置:```bash
# Rate limiting (e.g., "500K" for 500KB/s, "1M" for 1MB/s)
YOUTUBE_RATE_LIMIT=500K

# Retry configuration
YOUTUBE_MAX_RETRIES=5
YOUTUBE_RETRY_DELAY=2.0
YOUTUBE_TIMEOUT=600

# Caching
YOUTUBE_ENABLE_CACHE=true
YOUTUBE_CACHE_TTL=3600

# Logging level
LOG_LEVEL=INFO

MCP客户端配置

克劳德桌面(macOS)

添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json:```json
{
"mcpServers": {
"youtube-mcp-server": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/youtube-mcp-server-enhanced",
"python",
"-m",
"src.youtube_mcp_server.server"
],
"env": {
"YOUTUBE_RATE_LIMIT": "500K",
"YOUTUBE_MAX_RETRIES": "5",
"YOUTUBE_RETRY_DELAY": "2.0",
"YOUTUBE_TIMEOUT": "600",
"YOUTUBE_ENABLE_CACHE": "true",
"YOUTUBE_CACHE_TTL": "3600"
}
}
}
}


#### 其他MCP客户端

对于其他MCP客户端,将服务器命令配置为:```bash
uv run --directory /path/to/youtube-mcp-server-enhanced python -m src.youtube_mcp_server.server

默认值

  • 速率限制:无(使用YouTube的默认值)
  • 最大重试次数:5(为提高可靠性,从3增加)
  • 重试延迟:2.0秒(指数回退)
  • 超时:600秒(10分钟)
  • 缓存TTL:3600秒(1小时)
  • 缓存:默认启用

🎯 可用的MCP工具

数据提取

工具 说明 示例
get_video_info() 提取全面的视频元数据 get_video_info("https://youtube.com/watch?v=...")
get_channel_info() 提取频道信息和统计数据(支持多种URL格式) get_channel_info("https://youtube.com/@channel") 或 get_channel_info("https://youtube.com/ChannelName")
get_playlist_info() 提取播放列表详细信息和视频列表 get_playlist_info("https://youtube.com/playlist?list=...")
get_video_comments() 提取视频评论和回复 get_video_comments("https://youtube.com/watch?v=...", 50)
get_video_transcript() 提取视频转录/字幕 get_video_transcript("https://youtube.com/watch?v=...")

搜索与发现

工具 说明 示例
search_youtube() 搜索视频、频道或播放列表 search_youtube("Python tutorials", "video", 20)
get_trending_videos() 按地区获取热门视频 get_trending_videos("US", 15)

分析和见解

工具 说明 示例
analyze_video_engagement() 使用基准分析参与度指标 analyze_video_engagement("https://youtube.com/watch?v=...")
search_transcript() 在视频记录中搜索文本 search_transcript("https://youtube.com/watch?v=...", "query")

批量操作

工具 说明 示例
batch_extract_urls() 同时处理多个URL batch_extract_urls(["url1", "url2"], "video")

系统管理

工具 说明 示例
get_extractor_health() 监控提取器的健康状况和状态 get_extractor_health()
get_extractor_config() 查看当前配置 get_extractor_config()
clear_extractor_cache() 清除所有缓存数据 clear_extractor_cache()

MCP提示

提示 描述 示例
analyze-video 全面的视频分析,可选择评论/成绩单 analyze-video(url, include_comments=true, include_transcript=true)
compare-videos 比较多个视频中的参与度指标 compare-videos([url1, url2, url3])

📊 数据模型

视频信息表```python

{
"metadata": {
"id": "video_id",
"title": "Video Title",
"description": "Video description...",
"uploader": "Channel Name",
"uploader_id": "channel_id",
"upload_date": "20240101",
"tags": ["tag1", "tag2"],
"categories": ["Entertainment"],
"thumbnail": "https://..."
},
"statistics": {
"view_count": 1000,
"like_count": 50,
"comment_count": 25,
"duration_seconds": 120,
"duration_string": "2:00"
},
"engagement": {
"like_to_view_ratio": 0.05,
"comment_to_view_ratio": 0.025,
"like_rate_percentage": "5.000%",
"comment_rate_percentage": "2.500%"
},
"technical": {
"age_limit": 0,
"availability": "public",
"live_status": "not_live"
}
}


### 频道信息```python
{
"id": "channel_id",
"name": "Channel Name",
"url": "https://youtube.com/@channel",
"description": "Channel description...",
"avatar_url": "https://...",
"banner_url": "https://...",
"verified": true,
"country": "US",
"language": "en",
"tags": ["tag1", "tag2"],
"statistics": {
"subscriber_count": 10000,
"video_count": 150,
"view_count": 500000
}
}

播放列表信息```python

{
"id": "playlist_id",
"title": "Playlist Title",
"description": "Playlist description...",
"uploader": "Channel Name",
"uploader_id": "channel_id",
"video_count": 25,
"total_duration_seconds": 7200,
"total_duration_formatted": "2h 0m",
"total_views": 50000,
"videos": [
{
"video_id": "video_id",
"title": "Video Title",
"uploader": "Channel Name",
"duration": 300,
"view_count": 2000,
"playlist_index": 1
}
]
}


## 🔍 使用示例

### 基本视频分析```python
# Get comprehensive video information
video_info = await get_video_info("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

# Extract video comments
comments = await get_video_comments("https://www.youtube.com/watch?v=dQw4w9WgXcQ", max_comments=50)

# Get video transcript
transcript = await get_video_transcript("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

# Search within transcript
results = await search_transcript("https://www.youtube.com/watch?v=dQw4w9WgXcQ", "never gonna")

频道和播放列表分析```python

Get channel information

channel_info = await get_channel_info("https://www.youtube.com/@RickAstleyYT")

Get playlist details

playlist_info = await get_playlist_info("https://www.youtube.com/playlist?list=...")


### 搜索和发现```python
# Search for videos
results = await search_youtube("Python programming tutorials", "video", 10)

# Get trending videos
trending = await get_trending_videos("US", 20)

高级分析```python

Analyze video engagement with benchmarks

engagement = await analyze_video_engagement("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

Compare multiple videos

comparison = await compare_videos([
"https://youtube.com/watch?v=video1",
"https://youtube.com/watch?v=video2"
])


### 批处理```python
# Process multiple URLs concurrently
results = await batch_extract_urls([
"https://youtube.com/watch?v=video1",
"https://youtube.com/watch?v=video2"
], "video")

⚡ 性能特点

缓存

  • 内存缓存:可配置的基于TTL的缓存
  • 缓存密钥:每种请求类型和参数的唯一键
  • 缓存管理:查看统计数据、清除缓存、配置TTL

重试逻辑

  • 自动检索:可配置的重试尝试
  • 指数退避:增加重试之间的延迟
  • 错误处理:故障时的优雅降级

批处理

  • 并行提取:使用asyncio同时处理多个URL
  • 异步操作:无阻塞I/O,性能更好
  • 结果聚合:结合成功/失败计数的结果

🏥 健康监测

健康状况```python

health = await get_extractor_health()

Returns:

{
"health": {
"status": "healthy",
"yt_dlp_available": true,
"yt_dlp_version": "2025.6.30",
"cache": {"enabled": true, "size": 5, "ttl": 3600},
"config": {"rate_limit": "1M", "max_retries": 3, "timeout": 300}
},
"cache": {
"enabled": true,
"size": 5,
"ttl": 3600,
"keys": ["key1", "key2"],
"total_keys": 5
},
"server_version": "0.1.0",
"mcp_version": "1.0.0"
}


### 配置视图```python
config = await get_extractor_config()
# Returns current extractor settings and status

🚨 错误处理

重试策略

  • 自动检索:默认情况下最多5次尝试(可配置)
  • 指数退避:2秒、4秒、8秒延迟
  • 速率限制:500KB/s限制,睡眠间隔为2秒
  • 故障弱化:尽可能返回部分结果

错误类型

  • YouTubeExtractor错误:提取特定错误
  • 无效URL错误:无效的YouTube URL格式
  • 运行时错误:一般执行错误

故障排除

利率限制问题

如果遇到速率限制:

  1. 增加睡眠间隔 .env: YOUTUBE_RETRY_DELAY=3.0
  2. 利率下限: YOUTUBE_RATE_LIMIT=300K
  3. 减少并发请求

yt-dlp不工作

  1. 确保安装了紫外线: uv --version
  2. 验证yt-dlp安装: uv run yt-dlp --version
  3. 服务器自动使用 uv run yt-dlp 如果直接访问失败

MCP连接问题

  1. 代码更改后重新启动MCP客户端
  2. 检查日志中的特定错误消息
  3. 验证环境变量是否正确加载

🔧 发展

运行服务器

⚠️ 始终使用 uv run 为了确保适当的依赖关系管理:```bash

Start the MCP server (recommended)

uv run python -m src.youtube_mcp_server.server

Or if you have a run_server.py file

uv run python run_server.py


### 测试```bash
# Run all tests
uv run pytest tests/

# Run specific test file
uv run pytest tests/test_basic.py

# Run with coverage
uv run pytest --cov=src tests/

📈 用例

内容分析

  • 视频表演:分析浏览次数、参与度指标
  • 渠道增长:跟踪订户并查看计数趋势
  • 内容发现:查找趋势和流行内容

研究与分析

  • 市场调研:分析竞争对手的渠道和内容
  • 趋势分析:识别热门话题和内容类型
  • 观众洞察:了解观众偏好和行为

内容管理

  • 播放列表组织:管理和分析视频收藏
  • 评论审核:提取和分析用户反馈
  • 成绩单分析:处理和搜索视频内容

🤝 贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 添加新功能的测试
  5. 提交拉取请求

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

🙏 致谢

  • yt-dlp:核心YouTube提取引擎
  • FastMCP:MCP服务器框架
  • 派丹蒂克:数据验证和序列化

📞 支持

  • 问题: GitHub问题
  • 讨论: GitHub讨论
  • 电子邮件: info@labeveryday.com

🗺️ Roadmap

  • [x] 批量处理 多个视频
  • [x] 缓存层 为了提高性能
  • [x] 高级分析 (参与度分析、基准)
  • [x] 速率限制 配额管理
  • [ ] 导出功能 (JSON、CSV等)
  • [ ] WebSocket支持 用于实时更新
  • [ ] 集成示例 与流行的MCP客户端

由以下材料制成❤️ 作者:杜安·莱特富特

使开发人员能够通过模型上下文协议从YouTube内容中提取有意义的见解。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
You Tube MCP Server Enhanced 怎么安装?

在客户端按下面的安装命令接入:pip install uv。装完在客户端配置里引用同一个包或端点。

You Tube MCP Server Enhanced 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

You Tube MCP Server Enhanced 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

You Tube MCP Server Enhanced 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

You Tube MCP Server Enhanced 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

You Tube MCP Server Enhanced 能提供哪些能力?

资料显示能力标签包括 批量处理、Python、Claude。具体工具清单以官方文档为准。

You Tube MCP Server Enhanced 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

You Tube MCP Server Enhanced 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。