https://github.com/kevinwatt/yt-dlp-mcp
A Model Context Protocol (MCP) server that bridges YouTube content with Large Language Models using yt-dlp.
https://github.com/kevinwatt/yt-dlp-mcp
Last synced: 4 months ago
JSON representation
A Model Context Protocol (MCP) server that bridges YouTube content with Large Language Models using yt-dlp.
- Host: GitHub
- URL: https://github.com/kevinwatt/yt-dlp-mcp
- Owner: kevinwatt
- License: mit
- Created: 2025-02-10T18:40:09.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-20T10:48:47.000Z (4 months ago)
- Last Synced: 2025-02-20T11:34:23.199Z (4 months ago)
- Language: JavaScript
- Homepage:
- Size: 36.1 KB
- Stars: 4
- Watchers: 1
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - YouTube MCP Server - Integrates with yt-dlp to download video and audio content from various platforms, and fetch subtitles in SRT format for processing by LLMs. Provides a privacy-focused direct download experience without tracking. (Digital Marketing)
README
# yt-dlp-mcp
An MCP server implementation that integrates with yt-dlp, providing video and audio content download capabilities (e.g. YouTube, Facebook, Tiktok, etc.) for LLMs.
## Features
* **Subtitles**: Download subtitles in SRT format for LLMs to read
* **Video Download**: Save videos to your Downloads folder with resolution control
* **Audio Download**: Save audios to your Downloads folder
* **Privacy-Focused**: Direct download without tracking
* **MCP Integration**: Works with Dive and other MCP-compatible LLMs
## Installation
### Prerequisites
Install `yt-dlp` based on your operating system:
```bash
# Windows
winget install yt-dlp
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
```
### With [Dive Desktop](https://github.com/OpenAgentPlatform/Dive)
1. Click "+ Add MCP Server" in Dive Desktop
2. Copy and paste this configuration:
```json
{
"mcpServers": {
"yt-dlp": {
"command": "npx",
"args": [
"-y",
"@kevinwatt/yt-dlp-mcp"
]
}
}
}
```
3. Click "Save" to install the MCP server
## Tool Documentation
* **list_subtitle_languages**
* List all available subtitle languages and their formats for a video (including auto-generated captions)
* Inputs:
* `url` (string, required): URL of the video
* **download_video_subtitles**
* Download video subtitles in any available format. Supports both regular and auto-generated subtitles
* Inputs:
* `url` (string, required): URL of the video
* `language` (string, optional): Language code (e.g., 'en', 'zh-Hant', 'ja'). Defaults to 'en'
* **download_video**
* Download video to user's Downloads folder
* Inputs:
* `url` (string, required): URL of the video
* `resolution` (string, optional): Video resolution ('480p', '720p', '1080p', 'best'). Defaults to '720p'
* **download_audio**
* Download audio in best available quality (usually m4a/mp3 format) to user's Downloads folder
* Inputs:
* `url` (string, required): URL of the video
## Usage Examples
Ask your LLM to:
```
"List available subtitles for this video: https://youtube.com/watch?v=..."
"Download a video from facebook: https://facebook.com/..."
"Download Chinese subtitles from this video: https://youtube.com/watch?v=..."
"Download this video in 1080p: https://youtube.com/watch?v=..."
"Download audio from this YouTube video: https://youtube.com/watch?v=..."
```
## Manual Start
If needed, start the server manually:
```bash
npx @kevinwatt/yt-dlp-mcp
```
## Requirements
* Node.js 20+
* `yt-dlp` in system PATH
* MCP-compatible LLM service
## Documentation
- [API Reference](./docs/api.md)
- [Configuration](./docs/configuration.md)
- [Error Handling](./docs/error-handling.md)
- [Contributing](./docs/contributing.md)
## License
MIT
## Author
Dewei Yen