YouTube MCP Server

概述

YouTube MCP 服务器允许 AI 语言模型与 YouTube 内容交互，提供视频信息、字幕、频道和播放列表管理功能。

安装方法

方法 1：通过 Smithery 自动安装（推荐）

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

方法 2：手动安装

npm install @modelcontextprotocol/server-youtube

配置

1. 获取 YouTube Data API v3 密钥：

   • 在 Google Cloud 控制台创建项目
   • 启用 YouTube Data API v3
   • 创建 API 密钥

2. 设置环境变量：

   • YOUTUBE_API_KEY：您的 API 密钥
   • YOUTUBE_TRANSCRIPT_LANG：字幕默认语言（可选，默认为 'en'）

3. 添加到 MCP 客户端配置（例如 Claude Desktop）：

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-youtube"],
      "env": {
        "YOUTUBE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

主要功能示例

视频操作

// 获取视频详情
const video = await youtube.videos.getVideo({
  videoId: "video-id"
});

// 获取视频字幕
const transcript = await youtube.transcripts.getTranscript({
  videoId: "video-id",
  language: "en"
});

// 搜索视频
const searchResults = await youtube.videos.searchVideos({
  query: "search term",
  maxResults: 10
});

频道操作

// 获取频道信息
const channel = await youtube.channels.getChannel({
  channelId: "channel-id"
});

// 列出频道视频
const videos = await youtube.channels.listVideos({
  channelId: "channel-id",
  maxResults: 50
});

播放列表操作

// 获取播放列表内容
const playlistItems = await youtube.playlists.getPlaylistItems({
  playlistId: "playlist-id",
  maxResults: 50
});

// 获取播放列表详情
const playlist = await youtube.playlists.getPlaylist({
  playlistId: "playlist-id"
});

其他信息

• 支持多语言字幕检索
• 提供视频统计数据（观看次数、点赞数、评论数）
• 可在字幕和频道内容中搜索
• 根据 MIT 许可证发布

有关更详细的信息，请访问 Smithery 页面。