yt-dlp-mcp/README.md
2025-02-12 20:01:35 +08:00

75 lines
1.5 KiB
Markdown

# YouTube MCP Server
[![smithery badge](https://smithery.ai/badge/@kevinwatt/yt-dlp-mcp)](https://smithery.ai/server/@kevinwatt/yt-dlp-mcp)
Uses `yt-dlp` to download YouTube content and connects it to LLMs via [Model Context Protocol](https://modelcontextprotocol.io/introduction).
## Features
- Download YouTube subtitles (SRT format) for LLMs to read
- Download YouTube videos to your Downloads folder
- Integrates with Dive and other MCP-compatible LLMs
## Installation
### Installing via Smithery
To install YouTube MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kevinwatt/yt-dlp-mcp):
```bash
npx -y @smithery/cli install @kevinwatt/yt-dlp-mcp --client claude
```
### Installing Manually
1. Install `yt-dlp` (Pip, Homebrew and WinGet both work great here)
yt-dlp-mcp requires the yt-dlp package. Install it based on your operating system:
Windows
```bash
winget install yt-dlp
```
MacOS
```bash
brew install yt-dlp
```
Linux
```bash
pip install yt-dlp
```
2. Install this via [dive](https://github.com/OpenAgentPlatform/Dive):
```json
{
"mcpServers": {
"yt-dlp-mcp": {
"command": "npx",
"args": [
"-y",
"@kevinwatt/yt-dlp-mcp"
]
}
}
}
```
## Usage Examples
Ask your LLM to:
- "Summarize the YouTube video <<URL>>"
- "Download this YouTube video: <<URL>>"
## Manual Start
If needed, you can start the server manually:
```bash
yt-dlp-mcp
```
## Requirements
- `yt-dlp` installed and in PATH
- Node.js 20+
- MCP-compatible LLM service