Metadata-Version: 2.4
Name: yt-dlp-mcp
Version: 0.1.0
Summary: MCP server for YouTube video operations using yt-dlp
Author-email: User <user@example.com>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=0.2.0
Requires-Dist: yt-dlp>=2023.12.30
Requires-Dist: youtube-search-python>=1.6.6
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: mypy; extra == "dev"

# yt-dlp MCP Server

A Model Context Protocol (MCP) server that provides YouTube video operations using yt-dlp.

## Features

- **Get Transcriptions**: Extract transcriptions from YouTube videos with optional timestamp preservation
- **Search Videos**: Search for YouTube videos by terms and return URLs
- **List Channel Videos**: Get recent videos from a YouTube channel

## Installation

```bash
pip install -e .
```

## Usage

Run the MCP server:

```bash
yt-dlp-mcp
```

## Tools

### get_transcription
- **Input**: YouTube URL, optional timestamp preservation flag
- **Output**: Video transcription text

### search_videos
- **Input**: Search terms
- **Output**: List of YouTube video URLs

### list_channel_videos
- **Input**: Channel name/URL, number of videos to return
- **Output**: List of recent video URLs from the channel

## Requirements

- Python 3.8+
- yt-dlp
- fastmcp
- youtube-search-python
