YouTube MCP 服务器

这是一个针对YouTube的模型上下文协议（MCP）服务器实现，使AI语言模型能够通过标准化接口与YouTube内容进行交互。

功能特性

视频信息

• 获取视频详情（标题、描述、时长等）
• 列出频道视频
• 获取视频统计数据（观看次数、点赞数、评论数）
• 在YouTube上搜索视频

字幕管理

• 获取视频字幕
• 支持多种语言
• 获取带时间戳的字幕
• 在字幕中进行搜索

频道管理

• 获取频道详情
• 列出频道播放列表
• 获取频道统计数据
• 在频道内容中进行搜索

播放列表管理

• 列出播放列表项目
• 获取播放列表详情
• 在播放列表中进行搜索
• 获取播放列表视频字幕

安装

通过Smithery安装

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

npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude

手动安装

npm install zubeid-youtube-mcp-server

配置

设置以下环境变量：

• YOUTUBE_API_KEY：您的YouTube Data API密钥
• YOUTUBE_TRANSCRIPT_LANG：字幕的默认语言（可选，默认为英文）

与MCP客户端配合使用

将以下内容添加到您的MCP客户端配置中（例如Claude Desktop）：

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "zubeid-youtube-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "<您的API密钥>"
      }
    }
  }
}

在VS Code中使用

要实现一键安装，请点击下面的安装按钮之一：

手动安装

如果您更喜欢手动安装，首先检查本节顶部的安装按钮。否则，请按照以下步骤操作：

将以下JSON块添加到VS Code的用户设置（JSON）文件中。您可以通过按Ctrl + Shift + P并输入Preferences: Open User Settings (JSON)来完成此操作。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "YouTube API Key",
        "password": true
      }
    ],
    "servers": {
      "youtube": {
        "command": "npx",
        "args": ["-y", "zubeid-youtube-mcp-server"],
        "env": {
          "YOUTUBE_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

或者，您可以将其添加到工作区中的.vscode/mcp.json文件中：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "YouTube API Key",
      "password": true
    }
  ],
  "servers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "zubeid-youtube-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "${input:apiKey}"
      }
    }
  }
}

YouTube API设置

1. 访问Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用YouTube Data API v3
4. 创建API凭据（API密钥）
5. 复制API密钥用于配置

示例

管理视频

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

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

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

管理频道

// 获取频道详情
const channel = await youtube.channels.getChannel({
  channelId: "频道ID"
});

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

管理播放列表

// 获取播放列表项目
const playlistItems = await youtube.playlists.getPlaylistItems({
  playlistId: "播放列表ID",
  maxResults: 50
});

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

开发

# 安装依赖
npm install

# 运行测试
npm test

# 构建
npm run build

# 代码检查
npm run lint

贡献

有关为该仓库做贡献的信息，请参阅CONTRIBUTING.md。

许可证

本项目采用MIT许可证 - 详情请参见LICENSE文件。