YouTube MCP Integration
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Allows searching YouTube videos, retrieving detailed video information, and fetching video transcripts with timestamps and metadata.
YouTube MCP Integration
This project provides a Model Context Protocol (MCP) integration for YouTube, allowing LLMs to search YouTube, get video information, and retrieve transcripts via standardized tools.
Features
- YouTube Search Tool: Search for videos on YouTube with configurable result limits
- Video Info Tool: Get detailed information about a YouTube video
- Transcript Tool: Retrieve and parse the transcript of a YouTube video
Architecture
The implementation follows the Model Context Protocol (MCP) specification, which standardizes how LLMs interact with external tools and resources. The architecture consists of:
- MCP Server: Provides YouTube functionality as MCP tools through HTTP/SSE transport
- YouTube API Integration: Scrapes YouTube data to provide search, video info, and transcript functionality
- MCP Client: Example client showing how to consume the MCP YouTube tools
Getting Started
Prerequisites
- Node.js 18+
- npm
Installation
Running the Server
Start the MCP server:
The server will start on http://localhost:3000 with the following endpoints:
- SSE endpoint:
/sse
- Message endpoint:
/messages
Using with an MCP Client
The MCP tools can be used with any MCP-compatible client. Here's an example of how to use the tools:
Available Tools
youtube_search
Search for YouTube videos.
Arguments:
query
(string, required): The search querylimit
(number, optional): Maximum number of results (1-10, default: 5)
Response: A list of video results with details like title, video ID, URL, thumbnail, description, channel info, view count, and publish date.
youtube_get_video_info
Get detailed information about a YouTube video.
Arguments:
input
(string, required): YouTube video ID or URL
Response: Detailed video information including title, description, view count, publish date, channel details, and thumbnail URL.
youtube_get_transcript
Get the transcript of a YouTube video.
Arguments:
input
(string, required): YouTube video ID or URL
Response: The video transcript with timestamped entries, along with basic video information.
License
MIT
Acknowledgements
This server cannot be installed
An MCP server that enables LLMs to search YouTube, retrieve video information, and access video transcripts through standardized tools.