YouTube MCP 服务器

铁匠徽章

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

特征

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

Related MCP server: YouTube Translate MCP

先决条件

Node.js（v16+）
YouTube 数据 API 密钥

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 YouTube MCP 服务器：

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：

# Build the Docker image
docker build -t youtube-mcp-server .

# Run the container
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

使用统计工具

// Get video statistics
{
  "type": "tool",
  "name": "get-video-stats",
  "parameters": {
    "videoId": "dQw4w9WgXcQ"
  }
}

// Compare multiple videos
{
  "type": "tool",
  "name": "compare-videos",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ", "9bZkp7q19f0"]
  }
}

使用成绩单摘要提示

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

使用增强转录工具

// Basic multi-video transcript extraction
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ", "9bZkp7q19f0"],
    "format": "timestamped"
  }
}

// With search and time filtering
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ"],
    "filters": {
      "timeRange": {
        "start": 60,  // Start at 60 seconds
        "end": 180    // End at 180 seconds
      },
      "search": {
        "query": "never gonna",
        "contextLines": 2
      }
    },
    "format": "merged"
  }
}

// With smart segmentation for easier analysis
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ"],
    "filters": {
      "segment": {
        "count": 5,
        "method": "smart"  // Breaks at natural pauses
      }
    },
    "format": "timestamped",
    "language": "en"
  }
}

使用增强的转录分析功能

// Get key moments from a video
{
  "type": "tool",
  "name": "get-key-moments",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "maxMoments": "5"
  }
}

// Get a segmented transcript
{
  "type": "tool",
  "name": "get-segmented-transcript",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "segmentCount": "4"
  }
}

// Get a segment-by-segment analysis
{
  "type": "prompt",
  "name": "segment-by-segment-analysis",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "segmentCount": "4"
  }
}

// Get customized transcript summary
{
  "type": "prompt",
  "name": "transcript-summary",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "language": "en",
    "summaryLength": "detailed",
    "includeKeywords": "true"
  }
}

错误处理

服务器处理各种错误情况，包括：

API 密钥无效
未找到视频或频道
无法获取成绩单
网络问题

执照

麻省理工学院

YouTube MCP Server