MCP 服务器

YouTube Transcript MCP Server

Enables fetching, searching, and summarizing YouTube video transcripts with multi-language support.

README

YouTube Transcript MCP Server

A powerful Model Context Protocol (MCP) server that provides seamless access to YouTube video transcripts using the youtube-transcript-api library.

🚀 Features

📝 Get Full Transcripts - Fetch complete video transcripts in text or JSON format
🌍 Multi-Language Support - Discover and fetch transcripts in different languages
🔍 Smart Search - Search for specific text within video transcripts with context
📋 Transcript Summaries - Get concise summaries of video content
🔗 URL Flexibility - Works with any YouTube URL format or direct video IDs

🛠️ MCP Tools Available

1. `get_transcript`

Fetch the complete transcript for a YouTube video.

Parameters:

video_url_or_id: YouTube video URL or video ID
languages: (Optional) List of language codes (e.g., ['en', 'es'])
format_type: (Optional) Output format - 'text' or 'json' (default: 'text')

2. `get_available_languages`

Get all available transcript languages for a video.

Parameters:

video_url_or_id: YouTube video URL or video ID

3. `search_transcript`

Search for specific text within a video's transcript.

Parameters:

video_url_or_id: YouTube video URL or video ID
query: Text to search for
languages: (Optional) List of language codes to search in

4. `get_transcript_summary`

Get a summary of the video's transcript.

Parameters:

video_url_or_id: YouTube video URL or video ID
max_length: (Optional) Maximum summary length in characters (default: 1000)
languages: (Optional) List of language codes to use

📦 Installation

Clone the repository:

git clone https://github.com/Ayaanisthebest/MCP-tool-for-YouTube-.git
cd MCP-tool-for-YouTube-

Install dependencies:

pip install -e .

Or install manually:

pip install youtube-transcript-api mcp[cli] fastmcp

⚙️ MCP Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "python3",
      "args": ["-m", "youtube_transcript_mcp_server.server"]
    }
  }
}

Note: On macOS, use python3 instead of python. If you have a different Python setup, you can also use the full path:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/opt/homebrew/bin/python3",
      "args": ["-m", "youtube_transcript_mcp_server.server"]
    }
  }
}

🎯 Usage Examples

Get a transcript:

get_transcript("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

Search within a transcript:

search_transcript("dQw4w9WgXcQ", "never gonna give you up")

Get available languages:

get_available_languages("https://youtu.be/dQw4w9WgXcQ")

Get a summary:

get_transcript_summary("dQw4w9WgXcQ", max_length=500)

🔗 Supported URL Formats

The server can extract video IDs from various YouTube URL formats:

https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
https://www.youtube.com/embed/VIDEO_ID
https://www.youtube.com/shorts/VIDEO_ID
Direct video ID: VIDEO_ID

🧪 Testing

Run the test script to verify everything works:

python3 test_server.py

📋 Dependencies

youtube-transcript-api>=0.6.2 - Core YouTube transcript functionality
mcp[cli]>=1.3.0 - Model Context Protocol support
fastmcp>=0.4.0 - FastMCP framework for easy MCP server development

🐛 Error Handling

The server includes comprehensive error handling for:

Invalid video URLs or IDs
Videos without transcripts
Network connectivity issues
Unsupported languages
Rate limiting

📄 License

MIT License - see LICENSE file for details.

👨‍💻 About the Developer

Ayaan Ahmad - Full-Stack Developer & AI Enthusiast

I'm passionate about creating innovative tools that bridge the gap between AI and real-world applications. This YouTube Transcript MCP Server is part of my ongoing work to make AI more accessible and powerful through the Model Context Protocol ecosystem.

Connect with me: