YouTube Insights MCP Server

YouTube Insights MCP Server

一个 Model Context Protocol（MCP）服务，可从 YouTube 视频中提取洞察，包括解析字幕、按关键词发现视频以及获取频道信息。

功能

• 提取 YouTube 视频的字幕文本（支持多种语言）
• 按关键词搜索视频并获取元数据（观看次数、点赞数、缩略图等）
• 根据任意 YouTube 视频 URL 获取频道信息和最新视频
• 基于 FastMCP 的服务集成，便于部署
• MCP 工具支持流畅的 Agent 工作流

使用示例

查找热门视频并生成摘要

分析频道近期表现

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 youtubeinsights-mcp-server：

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

使用 uvx（推荐）

使用 uvx 时，无需进行特定安装。

将以下配置添加到 MCP 设置文件中（例如 Claude Desktop 的 claude_desktop_config.json）：

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

开发环境安装

1. 克隆此仓库

2. 将 .env.example 复制为 .env，并填入你的 YouTube Data API 凭据

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

可用的 MCP 工具

• get_youtube_transcript：从 YouTube 视频 URL 提取完整字幕文本（支持 ko、en）
• search_youtube_videos：按关键词搜索 YouTube 视频并获取关键元数据
• get_channel_info：根据任意 YouTube 视频 URL 获取频道元数据和近期上传的视频

MCP 工具描述示例

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

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

{
  "tool": "get_channel_info",
  "description": "Retrieve channel info (title, subscriber count, latest uploads) based on a video URL."
}

许可证

本项目采用 MIT License 许可。详情请参阅 LICENSE 文件。