mcp-server-youtube-transcript

This repository hosts a Model Context Protocol (MCP) server designed to retrieve transcripts from YouTube videos, supporting multiple video URL formats and language-specific transcript retrieval through a simple interface.

234
14

YouTube Transcript Server

This Model Context Protocol (MCP) server retrieves transcripts from YouTube videos, providing direct access to captions and subtitles through a simple interface. It can be installed via Smithery using the provided npx command or via mcp-get.

Components

  • Tools
    • get_transcript: Extracts transcripts from YouTube videos. Requires a YouTube video URL or ID and an optional language code (default: "en").

Key Features

Supports multiple video URL formats, language-specific transcript retrieval, and provides detailed metadata in responses.

Configuration

To use with Claude Desktop, add the provided server configuration to your settings.

Development

Requires Node.js 18+ and npm/yarn. Install dependencies with npm install, build with npm run build, and use npm run watch for auto-rebuild during development. Testing is done via npm test, and debugging is facilitated using the MCP Inspector (npm run inspector).

Usage Examples

Examples are provided for retrieving transcripts by video URL or ID, specifying the desired language.

The server validates inputs, handles API errors, implements timeouts, and provides detailed error messages. Licensed under the MIT License.

Repository

KI
kimtaeyoon83

kimtaeyoon83/mcp-server-youtube-transcript

Created

November 29, 2024

Updated

March 28, 2025

Language

JavaScript

Category

Developer Tools