Youtube Transcript Server

🚀 YouTube Transcription Server

A Model Context Protocol (MCP) server that enables the retrieval of transcriptions from YouTube videos. This server offers direct access to video captions and subtitles through a simple interface.

🚀 Quick Start

Installation via Smithery

Automatically install the YouTube Transcription Server for use with Claude Desktop through Smithery:

npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client claude

✨ Features

• Support for multiple video URL formats
• Retrieve transcriptions by language
• Include detailed metadata in responses

📦 Installation

Tool Installation

mcp-get is a command-line tool for installing and managing Model Context Protocol (MCP) servers.

npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript

📚 Documentation

Components

Tools

• get_transcript
  • Extract the transcription content of a YouTube video
  • Input:
    • url (string, required): YouTube video URL or video ID
    • lang (string, optional, default: "en"): Transcription language code (e.g., 'ko', 'en')

Configuration

When using with Claude Desktop, add the following server configuration:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Awesome-mcp-servers

awesome-mcp-servers is a curated list of MCP servers.

🔧 Technical Details

Development

Prerequisites

• Node.js 18 or higher
• npm or yarn

Setup

Install dependencies:

npm install

Build the server:

npm run build

Development with automatic rebuild:

npm run watch

Testing

npm test

Debugging

Since MCP servers communicate via standard input and output, debugging can be challenging. We recommend using MCP Inspector for development:

npm run inspector

Error Handling

The server implements robust error handling for common scenarios:

• Invalid video URLs or IDs
• Unavailable transcriptions
• Language availability issues
• Network errors

💻 Usage Examples

Basic Usage

1. Get a transcription via a video URL:

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/watch?v=VIDEO_ID",
  lang: "en"
});

2. Get a transcription via a video ID:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  lang: "ko"
});

3. How to extract YouTube subtitles in the Claude Desktop app

chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Extract subtitles

Security Considerations

The server:

• Validates all input parameters
• Handles YouTube API errors
• Implements a timeout mechanism for transcription retrieval
• Maintains the security of network communications

📄 License

[Add license information here]