subtitle-mcp

What is subtitle-mcp?

subtitle-mcp is a local server that provides subtitle management, transcription, summarization, and comprehension assessment services. It is designed for users who need to process, analyze, and generate subtitles from local files or YouTube videos without relying on cloud services.

How to use subtitle-mcp?

Install dependencies with pip install -r requirements.txt, then configure a directory for .srt files. Use the server’s tools to load subtitles, transcribe audio/video files into .srt, extract YouTube subtitles, and generate summaries or assessments.

Key features of subtitle-mcp

• Load and retrieve .srt subtitle files from a specified directory.
• Generate concise summaries and highlight key points from subtitle content.
• Transcribe audio (.mp3, .wav) and video (.mp4, .mov) into .srt using Whisper.
• Extract official subtitles from YouTube videos or auto‑transcribe if unavailable.
• Assess comprehension based on the subtitle content.

Use cases of subtitle-mcp

• Summarizing lecture or meeting recordings from subtitle files.
• Transcribing interview audio or video clips into searchable subtitles.
• Downloading and analyzing YouTube video subtitles for research or study.
• Creating comprehension quizzes from subtitle content for language learning.

FAQ from subtitle-mcp

What file formats does subtitle-mcp support for transcription?

It supports audio formats .mp3 and .wav, and video formats .mp4 and .mov. Transcriptions are output as .srt subtitle files.

Does subtitle-mcp require an internet connection?

Most tasks run entirely locally. An internet connection is needed only for extracting subtitles from YouTube videos or downloading audio for auto‑transcription.

How do I specify the subtitle directory?

The directory for .srt files is specified in the server configuration when loading subtitles. The README notes that you “load .srt subtitle files from a specified directory” without further details.

Can subtitle-mcp transcribe YouTube videos without official subtitles?

Yes, if official subtitles are unavailable, subtitle-mcp can automatically transcribe the YouTube video’s audio using its built‑in ASR model.

Is there a limit on file size or duration?

The README does not mention any specific limits on file size or duration for transcription or subtitle processing.