VidCap YouTube API - MCP Server

This project provides a Model Context Protocol (MCP) server that acts as a proxy to the VidCap YouTube API, allowing AI assistants to easily access YouTube video data and functionalities. It also serves as a boilerplate for building custom MCP servers.

• Github
• NPM

Table of Contents

• VidCap YouTube API
• MCP Client Integration
  • Claude Desktop Configuration
  • Claude Code Integration
  • Security Best Practices
  • Advanced Configuration
  • Troubleshooting
• Available MCP Tools
• Source Code Overview

VidCap YouTube API

This server also proxies requests to the VidCap YouTube API, providing convenient access to YouTube video data and functionalities. You will need a VIDCAP_API_KEY set in your environment variables.

Endpoints are available under the /api/v1/youtube/ path:

• GET /info
  • Description: Get and save YouTube video information.
  • Query Parameters:
    • url (string, required): YouTube video URL.
    • cache (boolean, optional, default: true): Whether to cache video info.
• GET /media
  • Description: Get available media formats for a YouTube video.
  • Query Parameters:
    • url (string, required): YouTube video URL.
• GET /caption
  • Description: Get video captions/transcript.
  • Query Parameters:
    • url (string, required): YouTube video URL.
    • locale (string, optional, default: 'en'): Language code for captions.
    • model (string, optional): AI model for processing.
    • ext (enum, optional): File extension for captions (json3, srv1, srv2, srv3, ttml, vtt).
• GET /summary
  • Description: Get AI-generated summary of video content.
  • Query Parameters:
    • url (string, required): YouTube video URL.
    • locale (string, optional, default: 'en'): Target language code for summary.
    • model (string, optional): AI model for summarization.
    • screenshot (string, optional, default: '0'): '1' to enable auto-screenshots for summary parts.
    • cache (boolean, optional): Whether to use cached results.
• GET /screenshot
  • Description: Get screenshot from video at specific timestamp.
  • Query Parameters:
    • url (string, required): YouTube video URL.
    • second (string, optional, default: '0'): Timestamp in seconds or YouTube time format.
• GET /screenshot-multiple
  • Description: Get multiple screenshots from video at different timestamps.
  • Query Parameters:
    • url (string, required): YouTube video URL.
    • second (array of strings, optional, default: ['0']): Array of timestamps in seconds.
• GET /comments
  • Description: Get YouTube video comments with optional pagination and replies.
  • Query Parameters:
    • url (string, optional): YouTube video URL.
    • videoId (string, optional): YouTube video ID. Note: Either url or videoId is required.
    • order (enum, optional, default: 'time'): Sort order for comments ('time', 'relevance').
    • format (enum, optional, default: 'plainText'): Format of comment text ('plainText', 'html').
    • pageToken (string, optional): Pagination token for retrieving next page of comments.
    • includeReplies (boolean, optional, default: false): Include comment replies.
    • hl (string, optional, default: 'en'): Language code for comments.
• GET /search
  • Description: Search YouTube videos with comprehensive filtering and pagination support.
  • Query Parameters:
    • query (string, required): Search query for YouTube videos.

... View full README on GitHub