mcp-youtube-subtitles-extractor

This MCP server is designed to extract subtitles from a given YouTube video link. It operates as an Azure Functions-based MCP service, exposing tools that you can invoke through an MCP host or the MCP Inspector. When connected, you’ll typically interact with a tool that accepts a YouTube URL and returns subtitles in a chosen language. Common workflows include using the local MCP server with a client or inspector to select a language and request subtitles, then confirming or refining the results as needed. The server supports workflows like listing available languages with a get_available_languages tool and retrieving subtitles with a get_subtitle tool, enabling you to fetch transcripts for the provided video URL.

To use it, connect your MCP host or the MCP Inspector to the local function app endpoint described in the README, then run the appropriate tools with a YouTube link. You may be prompted to choose a language code (for example en or ko) for the subtitle output. The process is designed to be integrated into broader MCP toolchains, so you can chain the subtitle extraction into summaries, translations, or further analyses as part of your MCP workflow.

Prerequisites:

• .NET 9 SDK
• Azure Functions Core Tools
• Azure CLI
• Azure Developer CLI (azd)
• Docker Desktop
• Visual Studio Code (with C# Dev Kit and Azure Functions extension, optional)

Installation steps:

1. Clone the repository or obtain the MCP server package:
   • git clone <repository-url>
   • Navigate to the function app project: src/McpYouTubeSubtitlesExtractor.FunctionApp
2. Install prerequisites (if not already installed):
   • Install .NET 9 SDK from the official site
   • Install Azure Functions Core Tools and Azure CLI
   • Install Azure Developer CLI (azd)
   • Install Docker Desktop
3. Run the server locally using Docker (recommended for MCP deployment):
   • docker pull aliencube/mcp-youtube-subtitles-extractor:latest
   • docker run -i aliencube/mcp-youtube-subtitles-extractor:latest Alternatively, run the function app directly in your environment following the repository’s local run instructions.
4. If you prefer local Azure Functions runtime without Docker, set up the function app locally per the README:
   • cd src/McpYouTubeSubtitlesExtractor.FunctionApp
   • func start
5. To deploy remotely, follow the Azure deployment steps (az login, azd up) described in the README under Run Azure Functions MCP server remotely.

Notes and tips:

• This MCP server focuses on extracting YouTube subtitles and is implemented as an Azure Functions app, so the local/remote endpoints are exposed via the Functions runtime.
• The README references tools such as get_available_languages and get_subtitle; these are used within MCP tooling (e.g., MCP Inspector) to select a language and fetch subtitles for a given YouTube URL.
• The project appears to be moved to a different repository, so verify the source/repo for any newer versions or alternative deployment instructions.
• If you encounter environment or port conflicts when running locally, ensure Docker is configured to expose the appropriate ports and that the Azure Functions runtime is not blocked by firewall rules.
• Since this is not a Node.js package, there is no npm package to install for this MCP server.