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

# Clone the repository
git clone https://github.com/your-username/ephor-youtube-mcp.git
cd ephor-youtube-mcp

# Install dependencies
npm install

# Build the project
npm run build

Running the Server

Start the MCP server:

npm run start

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:

// Initialize client
const client = new Client(
  { name: 'youtube-client', version: '1.0.0' },
  { capabilities: { tools: {} } }
);

// Connect to the server
await client.connect(transport);

// Search YouTube
const searchResults = await client.callTool({
  name: 'youtube_search',
  arguments: {
    query: 'javascript tutorial',
    limit: 3
  }
});

// Get video info
const videoInfo = await client.callTool({
  name: 'youtube_get_video_info',
  arguments: {
    input: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
  }
});

// Get video transcript
const transcript = await client.callTool({
  name: 'youtube_get_transcript',
  arguments: {
    input: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
  }
});

Available Tools

`youtube_search`

Search for YouTube videos.

Arguments:

query (string, required): The search query
limit (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

Model Context Protocol

This server cannot be installed

security - not tested

license - not found

quality - not tested

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.

An MCP server that enables LLMs to search YouTube, retrieve video information, and access video transcripts through standardized tools.

Related MCP Servers

Zoom Transcript MCP Server
forayconsulting
A
security
A
license
A
quality
An MCP server that enables users to list, download, search, and manage Zoom meeting transcripts through a structured interface.
Last updated -
6
1
JavaScript
MIT License
MCP Server Memory File
g0t4
-
security
F
license
-
quality
An MCP server that allows Claude and other LLMs to manage persistent memories across conversations through text file storage, enabling commands to add, search, delete and list memory entries.
Last updated -
2
TypeScript
mcp-browser-use
vinayak-mehta
-
security
A
license
-
quality
An MCP server that connects any MCP client (like Claude or Cursor) with the browser using browser-use, allowing clients to utilize existing LLMs without requiring additional API keys.
Last updated -
32
Python
Apache 2.0
mcp-ytTranscript
Dan-Camargo
-
security
F
license
-
quality
Simple MCP server that returns the transcription of a Youtube video using url and desired language.
Last updated -
Python

View all related MCP servers

Appeared in Searches

Tools or methods to search and analyze YouTube videos

YouTube MCP Integration