YouTube MCP 服务器

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

功能

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

前提条件

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

安装

通过 Smithery 安装

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

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

手动安装

1. 克隆此存储库：

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

2. 安装依赖项：

   npm install
   

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

   YOUTUBE_API_KEY=your_youtube_api_key_here
   PORT=3000
   

用法

构建和运行

1. 构建项目：

   npm run build
   

2. 运行服务器：

   npm start
   

3. 在开发模式下运行：

   npm run dev
   

4. 清理构建工件：

   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 - 获取特定视频的字幕，可以选择语言

统计工具

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

发现工具

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

分析工具

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

提示

• video-analysis - 生成 YouTube 视频的分析
• transcript-summary - 根据视频的字幕生成视频摘要

示例

访问视频字幕

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"
  }
}

错误处理

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

• 无效的 API 密钥
• 找不到视频或频道
• 字幕不可用
• 网络问题

许可证

MIT

致谢

• Model Context Protocol TypeScript SDK
• YouTube Data API
• YouTube Captions Scraper