Kimtaeyoon83 MCP Server Youtube Transcript

🚀 YouTube Transcription Server

A Model Context Protocol (MCP) server for retrieving transcriptions from YouTube videos. This server provides direct access to video captions and transcripts through a simple interface.

🚀 Quick Start

Installation via Smithery

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

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

✨ Features

• Support for multiple video URL formats.
• Ability to obtain transcriptions in specific languages.
• Detailed metadata information included in the response.

📦 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

Configuration

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

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

💻 Usage Examples

Basic Usage

1. Get the transcription by video URL:

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

2. Get the transcription by video ID:

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

Advanced Usage

3. How to extract YouTube captions in the Claude Desktop application:

chat: https://youtu.be/VIDEO_ID extract captions

📚 Documentation

Components

Tools

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

🔧 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 auto-rebuild:

npm run watch

Testing

npm test

Debugging

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

npm run inspector

Error Handling

The server implements robust error handling for common scenarios:

• Invalid video URL or ID.
• Unavailable transcripts.
• Language availability issues.
• Network errors.

📄 License

No license information provided in the original document.

Other Resources

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

⚠️ Important Note

This is an AI-translated version and may contain some inaccuracies or content that does not conform to English usage habits. For more accurate information, please refer to the original English document.