π¦
YouTube DLP
A Model Context Protocol (MCP) server that lets your AI interact with YouTube videos - extract video information, subtitles, and top comments without downloading.
0 installs
5 stars
2 forks
Trust: 49 β Fair
Devtools
Installation
npx youtube-dlp-serverAsk AI about YouTube DLP
Powered by Claude Β· Grounded in docs
I know everything about YouTube DLP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
YouTube DLP MCP Server
π¬ A Model Context Protocol (MCP) server that lets your AI interact with YouTube videos - extract video information, subtitles, and top comments without downloading.
β¨ Features
- πΉ Extract Video Info - Get comprehensive metadata (title, views, likes, description, etc.)
- π Extract Subtitles - Download manual subtitles and auto-generated captions
- π¬ Extract Comments - Get top comments sorted by likes with creator badges
- π Proxy Support - Works with HTTP/HTTPS/SOCKS proxies
- π Fast & Async - Non-blocking operations using asyncio
- π§ Easy Integration - Standard MCP protocol for AI assistants
π Quick Start
Install with uvx (Recommended)
uvx youtube-dlp-server
Install with pip
pip install youtube-dlp-server
youtube-dlp-server
Install from source
git clone <repository-url>
cd youtube-dlp-server
pip install -e .
python -m youtube_dlp_server
π οΈ Usage
Available Tools
1. get-video-info
Extract comprehensive video metadata:
{
"name": "get-video-info",
"arguments": {
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
}
2. get-video-subtitles
Extract subtitles and captions:
{
"name": "get-video-subtitles",
"arguments": {
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"languages": ["en", "es"],
"include_auto_captions": true
}
}
3. get-top-comments
Get top comments (max 20, default 10):
{
"name": "get-top-comments",
"arguments": {
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"count": 10
}
}
Proxy Configuration
Set the PROXY_URL environment variable:
# HTTP/HTTPS proxy
export PROXY_URL="http://proxy.example.com:8080"
# SOCKS proxy with auth
export PROXY_URL="socks5://user:pass@127.0.0.1:1080/"
# Run with proxy
youtube-dlp-server
π§ͺ Testing
With MCP Inspector
npx @modelcontextprotocol/inspector youtube-dlp-server
Manual Testing
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'β
Video: {info[\"title\"]}')
asyncio.run(test())
"
π Requirements
- Python 3.11+
- yt-dlp for YouTube processing
- MCP framework for AI integration
π€ Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- Submit a pull request
π License
MIT License - see LICENSE file for details.
π Links
- Homepage: GitHub Repository
- Issues: Report Issues
- MCP Documentation: Model Context Protocol
Made with β€οΈ for the AI community
