MCP 服务器

YouTube MCP Server

一个服务器，它通过模型上下文协议实现与 YouTube 数据的交互，允许用户搜索视频、检索视频/频道的详细信息以及获取评论。

README

YouTube MCP 服务器

一个用于与 YouTube 数据交互的模型上下文协议 (MCP) 服务器。该服务器提供资源和工具，通过 stdio 接口查询 YouTube 视频、频道、评论和字幕。

特性

搜索 YouTube 视频，具有高级过滤选项
获取有关特定视频和频道的详细信息
比较多个视频的统计数据
发现按地区和类别划分的热门视频
分析频道表现和视频统计数据
检索视频评论和字幕
生成视频分析和字幕摘要

前提条件

Node.js (v16+)
YouTube Data API 密钥

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 YouTube MCP Server：

npx -y @smithery/cli install @coyaSONG/youtube-mcp-server --client claude

手动安装

克隆此存储库：

git clone https://github.com/coyaSONG/youtube-mcp-server.git
cd youtube-mcp-server

安装依赖项：
```
npm install
```

在根目录中创建一个 .env 文件：

YOUTUBE_API_KEY=your_youtube_api_key_here
PORT=3000

用法

构建和运行

构建项目：
```
npm run build
```
运行服务器：
```
npm start
```
在开发模式下运行：
```
npm run dev
```
清理构建工件：
```
npm run clean
```

Docker 部署

该项目包含一个用于容器化部署的 Dockerfile：

# 构建 Docker 镜像
docker build -t youtube-mcp-server .

# 运行容器
docker run -p 3000:3000 --env-file .env youtube-mcp-server

API 参考

资源

youtube://video/{videoId} - 获取有关特定视频的详细信息
youtube://channel/{channelId} - 获取有关特定频道的信息
youtube://transcript/{videoId} - 获取特定视频的字幕
- 可选查询参数：?language=LANGUAGE_CODE (例如，en, ko, ja)

工具

基本工具

search-videos - 搜索 YouTube 视频，具有高级过滤选项
get-video-comments - 获取特定视频的评论
get-video-transcript - 获取特定视频的字幕，可以选择语言
enhanced-transcript - 高级字幕提取，具有过滤、搜索和多视频功能
get-key-moments - 从视频字幕中提取带有时间戳的关键时刻，以便于导航
get-segmented-transcript - 将视频字幕分成多个片段，以便于分析

统计工具

get-video-stats - 获取特定视频的统计信息
get-channel-stats - 获取订阅者数量、观看次数和其他频道统计信息
compare-videos - 比较多个视频的统计数据

发现工具

get-trending-videos - 检索按地区和类别划分的热门视频
get-video-categories - 获取特定地区的可用视频类别

分析工具

analyze-channel-videos - 分析来自特定频道的视频的性能趋势

提示词

video-analysis - 生成 YouTube 视频的分析
transcript-summary - 根据视频的字幕生成视频摘要，具有可自定义的长度和关键词提取
segment-by-segment-analysis - 通过分析视频的每个片段来提供内容的详细分解

示例

访问视频字幕

youtube://transcript/dQw4w9WgXcQ

获取特定语言的字幕

youtube://transcript/dQw4w9WgXcQ?language=en

使用统计工具

// 获取视频统计信息
{
  "type": "tool",
  "name": "get-video-stats",
  "parameters": {
    "videoId": "dQw4w9WgXcQ"
  }
}

// 比较多个视频
{
  "type": "tool",
  "name": "compare-videos",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ", "9bZkp7q19f0"]
  }
}

使用字幕摘要提示词

{
  "type": "prompt",
  "name": "transcript-summary",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "language": "en"
  }
}

使用增强字幕工具

// 基本的多视频字幕提取
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ", "9bZkp7q19f0"],
    "format": "timestamped"
  }
}

// 具有搜索和时间过滤
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ"],
    "filters": {
      "timeRange": {
        "start": 60,  // 从 60 秒开始
        "end": 180    // 到 180 秒结束
      },
      "search": {
        "query": "never gonna",
        "contextLines": 2
      }
    },
    "format": "merged"
  }
}

// 具有智能分段，便于分析
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ"],
    "filters": {
      "segment": {
        "count": 5,
        "method": "smart"  // 在自然停顿处断开
      }
    },
    "format": "timestamped",
    "language": "en"
  }
}

使用增强字幕分析功能

// 获取视频的关键时刻
{
  "type": "tool",
  "name": "get-key-moments",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "maxMoments": "5"
  }
}

// 获取分段字幕
{
  "type": "tool",
  "name": "get-segmented-transcript",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "segmentCount": "4"
  }
}

// 获取逐段分析
{
  "type": "prompt",
  "name": "segment-by-segment-analysis",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "segmentCount": "4"
  }
}

// 获取自定义字幕摘要
{
  "type": "prompt",
  "name": "transcript-summary",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "language": "en",
    "summaryLength": "detailed",
    "includeKeywords": "true"
  }
}