https://github.com/kdr/yt-mcp-server
MCP server with various utility functions for dealing with youtube data
https://github.com/kdr/yt-mcp-server
Last synced: about 2 months ago
JSON representation
MCP server with various utility functions for dealing with youtube data
- Host: GitHub
- URL: https://github.com/kdr/yt-mcp-server
- Owner: kdr
- Created: 2025-04-29T09:37:48.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-29T10:30:53.000Z (6 months ago)
- Last Synced: 2025-04-29T11:22:32.947Z (6 months ago)
- Language: Python
- Size: 759 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **yt-mcp-server** - MCP server with various utility functions for dealing with youtube data `python` `mcp` `server` `pip install git+https://github.com/kdr/yt-mcp-server` (AI/ML)
- awesome-mcp-servers - **yt-mcp-server** - MCP server with various utility functions for dealing with youtube data `python` `mcp` `server` `pip install git+https://github.com/kdr/yt-mcp-server` (🤖 AI/ML)
README
# yt-mcp-server
MCP server with various utility functions for dealing with YouTube data. This server provides tools for working with YouTube URLs, video IDs, and thumbnails.
## 📖 Resources
- [Model Context Protocol](https://modelcontextprotocol.io/introduction)
## Prerequisites
- Python 3.12 or higher
- [UV](https://github.com/astral-sh/uv) package manager
## Setup
### 1. Install UV
If you haven't installed UV yet, you can install it using:
```bash
brew install uv
# alternatively curl -LsSf https://astral.sh/uv/install.sh | sh
```
### 2. Installation Methods
#### Method 1: Install from GitHub (Recommended)
This is the simplest way to install and run the server:
```bash
uvx --from git+https://github.com/kdr/yt-mcp-server.git server
```
#### Method 2: Local Development Setup
If you want to modify the code locally:
```bash
git clone https://github.com/kdr/yt-mcp-server.git
cd yt-mcp-server
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windows
uv pip install -e .
```
### 3. Configure MCP Client
Add the following configuration to your MCP client settings:
```json
{
"mcpServers": {
"yt-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/kdr/yt-mcp-server.git",
"server"
]
}
}
}
```
For local development (Method 2), use this configuration instead:
```json
{
"mcpServers": {
"yt-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/yt-mcp-server/yt_mcp_server",
"run",
"main.py"
]
}
}
}
```
## Available Tools
The following tools are available to the LLM:
- `get_watch_url`: Returns the YouTube watch URL for a given video ID, optionally starting at a specific time
- Parameters:
- `video_id`: The YouTube video ID
- `start_time`: (Optional) The start time in seconds
- `get_thumbnail_url`: Returns the thumbnail URL for a given YouTube video ID
- Parameters:
- `video_id`: The YouTube video ID
- `get_normalized_url`: Normalizes various YouTube URL formats to the canonical watch URL and extracts the video ID
- Parameters:
- `url`: The YouTube URL to normalize