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

1. Clone the repository:

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

2. Install dependencies:

pip install -e .

3. 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:

• GitHub: @Ayaanisthebest
• Building the future of AI-powered tools, one MCP server at a time! 🚀

🤝 Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

📈 Roadmap

• [ ] Support for YouTube Shorts transcripts
• [ ] Batch transcript processing
• [ ] Transcript translation capabilities
• [ ] Enhanced search with fuzzy matching
• [ ] Transcript export to various formats

---

Made with ❤️ for the AI community