A powerful Model Context Protocol (MCP) server that enables AI assistants like Claude to work with video content. This server provides capabilities for downloading video transcripts in plain text and videos from various platforms including YouTube, Vimeo, Twitter/X, and TikTok.

This project is a fork from anaisbetts/mcp-youtube which only outputs the transcript with timestamps. This project outputs the transcript in plain text without timestamps for easy LLM consumption and adds the download tool.

• Download and process video subtitles/closed captions for AI analysis
• Download videos in high quality (up to 1080p)
• Support for multiple platforms:
  • YouTube
  • Vimeo
  • Twitter/X
  • TikTok
  • And more platforms supported by yt-dlp

Before installing the MCP server, make sure you have the following prerequisites:

The server requires yt-dlp to be installed on your system first. Here are the installation methods for different platforms:

Using WinGet (Recommended):

winget install yt-dlp

Using Homebrew:

brew install yt-dlp

Using package manager:

sudo apt install yt-dlp

FFmpeg is required for merging audio and video streams when downloading videos. Install it for your platform:

Using WinGet (Recommended):

winget install --id=Gyan.FFmpeg -e

Alternatively, you can install it using Chocolatey:

choco install ffmpeg

Or follow the manual installation guide.

Using Homebrew:

brew install ffmpeg

Using package manager:

sudo apt install ffmpeg

1. Install Node.js (version 18 or higher) and npm from nodejs.org
2. Verify installation:

   node --version
   npm --version

After installing the prerequisites above, you can install the MCP server using one of these methods:

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {    
    "video": {
      "command": "npx",
      "args": [
        "@felores/mcp-video"
      ],
      "env": {
        "DOWNLOADS_DIR": "path/to/downloads"
      }
    }
  }
}

Replace path/to/downloads with the path to your desired downloads directory.

This will automatically install and run the latest version of the server.

Install the mcp-installer, restart Claude, and prompt claude to install the Video MCP Server:

Install @felores/mcp-video with environment DOWNLOADS_DIR set to path/to/downloads

Modify path/to/downloads to your desired downloads directory system path.

1. Clone the repository:

   git clone https://github.com/felores/mcp-video.git
   cd mcp-video

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. Start the server:

   npm start

Add the following to your claude_desktop_config.json:

{
"mcpServers": {    
   "video": {
      "command": "node",
      "args": ["path/to/mcp-video/lib/index.mjs"],
      "env": {
        "DOWNLOADS_DIR": "path/to/downloads"
      }
    }
  }
}

This server provides two powerful tools that can be used by AI assistants through the Model Context Protocol:

• Downloads and processes video subtitles/closed captions into plain text format
• Removes timestamps and formatting for easy AI consumption
• Supports auto-generated captions when available
• Works with multiple languages (defaults to English)
• Input: Video URL from any supported platform
• Output: Clean, plain text transcript ready for AI analysis

• Downloads videos in high quality (limited to 1080p for reasonable file sizes)
• Automatically selects the best quality format
• Merges video and audio streams when necessary
• Saves files to a configurable downloads directory
• Input:
  • Video URL from any supported platform
  • Optional filename (recommended format: platform-id, e.g., 'youtube-MhOTvvmlqLM')
• Output:
  • Downloaded video file in MP4 format
  • File information including title, duration, resolution, and file size

Once installed, you can use this server through any MCP-compatible client (like Claude.ai). Here are some example prompts:

1. To analyze a video's content:

   Summarize the YouTube video https://youtube.com/watch?v=VIDEO_ID
   

2. To get specific information:

   What are the main points discussed in this video: https://youtube.com/watch?v=VIDEO_ID
   

The server will automatically:

1. Download the video's subtitles/closed captions
2. Process and clean the text
3. Make it available to the AI assistant for analysis

• DOWNLOADS_DIR: Specify a custom directory for downloaded videos (default: ./downloads)

• YouTube
• Vimeo
• Twitter/X
• TikTok
• And any platform supported by yt-dlp

• yt-dlp - Video downloader
• Model Context Protocol - AI communication protocol

MIT License - See COPYING for details.