YT Analysis

Provides YouTube video analysis via Gemini API, offering summaries and Q&A from YouTube URLs.

javascript

0

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "legorobotdude-yt-analysis-mcp": {
      "command": "node",
      "args": [
        "/path/to/yt-analysis-mcp/dist/index.js"
      ],
      "env": {
        "GEMINI_API_KEY": "your-key"
      }
    }
  }
}

You have an MCP Server that analyzes YouTube videos using Google Gemini. Pass a YouTube URL to get summaries or ask questions about the video content directly from your client, without downloading the video.

How to use

You interact with the server through an MCP client. Start the local MCP server process and then connect via your Claude Code or Claude Desktop configuration. Use the available tools to summarize videos or ask questions about the video content by providing the YouTube URL.

How to install

Prerequisites: Node.js and pnpm must be installed on your system.

git clone https://github.com/yourusername/yt-analysis-mcp.git
cd yt-analysis-mcp
pnpm install
pnpm build

Configuration

Set your Gemini API key to enable access to Google Gemini services.

export GEMINI_API_KEY=your-api-key

Usage with Claude Code

Add the MCP server as a background process for Claude Code using your project path to the built server.

claude mcp add -s user -e GEMINI_API_KEY=your-key yt-analysis -- node /path/to/yt-analysis-mcp/dist/index.js

Usage with Claude Desktop

Configure Claude Desktop to launch the MCP server from your local environment.

{
  "mcpServers": {
    "yt-analysis": {
      "command": "node",
      "args": ["/path/to/yt-analysis-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-key"
      }
    }
  }
}

Tools and endpoints

Use the following tools to interact with the YouTube content.

summarize_video: Generate a summary of a YouTube video with optional detail level and the ability to include timestamps.
ask_about_video: Pose a specific question about the video content and receive a targeted answer.

Supported URL formats

You can provide full YouTube URLs, including standard watch links, short links, and Shorts.

Development

Typical development workflow includes running in development mode, running tests, and building the project.

pnpm dev
pnpm test
pnpm build

License

MIT licensed.

Available tools

summarize_video

Summarize a YouTube video's content with an optional detail level and timestamps. Parameters include youtube_url and detail_level (brief, medium, detailed).

ask_about_video

Ask a specific question about a YouTube video's content. Parameters include youtube_url and question.