YouTube Vision MCP Server (youtube-vision)

MCP (Model Context Protocol) server that utilizes the Google Gemini Vision API to interact with YouTube videos. It allows users to get descriptions, summaries, answers to questions, and extract key moments from YouTube videos.

Features

• Analyzes YouTube videos using the Gemini Vision API.
• Provides multiple tools for different interactions:
  • General description or Q&A (ask_about_youtube_video)
  • Summarization (summarize_youtube_video)
  • Key moment extraction (extract_key_moments)
• Lists available Gemini models supporting generateContent.
• Configurable Gemini model via environment variable.
• Communicates via stdio (standard input/output).

Prerequisites

Before using this server, ensure you have the following:

• Node.js: Version 18 or higher recommended. You can download it from nodejs.org.
• Google Gemini API Key: Obtain your API key from Google AI Studio or Google Cloud Console.

Installation & Usage

There are two main ways to use this server:

Installing via Smithery

To install youtube-vision-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @minbang930/youtube-vision-mcp --client claude

Option 1: Using npx (Recommended for quick use)

The easiest way to run this server is using npx, which downloads and runs the package without needing a permanent installation.

You can configure it within your MCP client’s settings file (Claude, VSCode … ):

{
  "mcpServers": {
    "youtube-vision": {
      "command": "npx",
      "args": [
        "-y",
        "youtube-vision"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY",
        "GEMINI_MODEL_NAME": "gemini-2.0-flash"
      }
    }
  }
}

Replace "YOUR_GEMINI_API_KEY" with your actual Google Gemini API key.

Option 2: Manual Installation (from Source)

If you want to modify the code or run it directly from the source:

1. Clone the repository:

   git clone https://github.com/minbang930/Youtube-Vision-MCP.git
   cd youtube-vision
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Configure and run: