YouTube DLP MCP 服务器

🎬 一个让AI与YouTube视频互动的模型上下文协议（MCP）服务器 - 提取视频信息、字幕和热门评论，无需下载。

✨ 特性

• 📹 提取视频信息 - 获取全面的元数据（标题、观看次数、点赞数、描述等）
• 📝 提取字幕 - 下载手动添加的字幕和自动生成的字幕
• 💬 提取评论 - 获取按点赞排序的热门评论，并附带创作者徽章
• 🌐 代理支持 - 支持HTTP/HTTPS/SOCKS代理
• 🚀 快速且异步 - 使用asyncio进行非阻塞操作
• 🔧 易于集成 - 标准MCP协议用于AI助手

🚀 快速开始

使用uvx安装（推荐）

uvx youtube-dlp-server

使用pip安装

pip install youtube-dlp-server
youtube-dlp-server

从源码安装

git clone <repository-url>
cd youtube-dlp-server
pip install -e .
python -m youtube_dlp_server

🛠️ 使用方法

可用工具

1. get-video-info

提取全面的视频元数据：

{
  "name": "get-video-info",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  }
}

2. get-video-subtitles

提取字幕和字幕：

{
  "name": "get-video-subtitles",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "languages": ["en", "es"],
    "include_auto_captions": true
  }
}

3. get-top-comments

获取热门评论（最多20条，默认10条）：

{
  "name": "get-top-comments",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "count": 10
  }
}

代理配置

设置PROXY_URL环境变量：

# HTTP/HTTPS代理
export PROXY_URL="http://proxy.example.com:8080"

# 带认证的SOCKS代理
export PROXY_URL="socks5://user:pass@127.0.0.1:1080/"

# 使用代理运行
youtube-dlp-server

🧪 测试

使用MCP Inspector

npx @modelcontextprotocol/inspector youtube-dlp-server

手动测试

python -c "
import asyncio
from youtube_dlp_server.helper import extract_video_info
async def test():
    info = await extract_video_info('https://www.youtube.com/watch?v=dQw4w9WgXcQ')
    print(f'✅ 视频: {info[\"title\"]}')
asyncio.run(test())
"

📋 要求

• Python 3.11+
• yt-dlp用于处理YouTube内容
• MCP框架用于AI集成

🤝 贡献

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

📄 许可证

MIT许可证 - 查看LICENSE文件了解详情。

🔗 链接

• 主页: GitHub仓库
• 问题报告: 报告问题
• MCP文档: 模型上下文协议

---

为AI社区制作 ❤️