Youtubeinsights MCP Server

🚀 YouTube Video Analysis MCP Server

A server based on the Model Context Protocol (MCP) for extracting insights from YouTube videos, including subtitle parsing, keyword-based video discovery, and channel information retrieval.

🚀 Quick Start

This is a server based on the Model Context Protocol (MCP), designed to extract insights from YouTube videos. It supports subtitle parsing, keyword video discovery, and channel information retrieval.

✨ Features

• Extract subtitles from YouTube videos (supports multiple languages).
• Search for videos by keyword and retrieve metadata (views, likes, thumbnails, etc.).
• Obtain channel information and the latest videos through any YouTube video link.
• Integrate with the FastMCP-based server for easy deployment.
• Seamlessly integrate MCP tools into your workflow.

Example Application Scenarios

📦 Installation

Install using Smithery

Automatically install the youtubeinsights-mcp-server via Smithery:

npx -y @smithery/cli install @dabidstudio/youtubeinsights-mcp-server --client claude

Use uvx (Recommended)

When using uvx, no special installation is required. Add the following configuration to your MCP settings file (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "youtubeinsights": {
      "command": "uvx",
      "args": ["youtubeinsights-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "your-api-key"
      }
    }
  }
}

Development Installation

1. Clone this repository.
2. Copy .env.example to .env and fill in your YouTube Data API credentials:

{
  "mcpServers": {
    "youtubeinsights": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/youtubeinsights-mcp-server",
        "run",
        "youtubeinsights-mcp-server"
      ],
      "env": {
        "YOUTUBE_API_KEY": "your-api-key"
      }
    }
  }
}

💻 Usage Examples

Provided MCP Tools

• get_youtube_transcript: Extract the full transcript from a given YouTube video link.
• search_youtube_videos: Search for YouTube videos by keyword and retrieve key metadata.
• get_channel_info: Obtain channel information and the latest uploads based on any YouTube video link.

Example MCP Tool Descriptions

{
  "tool": "get_youtube_transcript",
  "description": "Extract subtitles from a given YouTube video link."
}

{
  "tool": "search_youtube_videos",
  "description": "Search for videos by keyword and return metadata, including views, likes, and thumbnails."
}

{
  "tool": "get_channel_info",
  "description": "Obtain channel information (title, subscriber count, latest uploads) based on a video link."
}

📄 License

This project is released under the MIT License. For more details, please refer to the LICENSE file.