YouTube MCP 服务器

一个用于 YouTube 的模型上下文协议 (MCP) 服务器实现，使 AI 语言模型能够通过标准化接口与 YouTube 内容进行交互。

功能

视频信息

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

文本记录管理

• 检索视频文本记录
• 支持多种语言
• 获取带时间戳的字幕
• 在文本记录中搜索

频道管理

• 获取频道详细信息
• 列出频道播放列表
• 获取频道统计信息
• 在频道内容中搜索

播放列表管理

• 列出播放列表项目
• 获取播放列表详细信息
• 在播放列表中搜索
• 获取播放列表视频文本记录

安装

通过 Smithery 安装

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

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

手动安装

npm install @modelcontextprotocol/server-youtube

配置

设置以下环境变量：

• YOUTUBE_API_KEY: 您的 YouTube Data API 密钥
• YOUTUBE_TRANSCRIPT_LANG: 文本记录的默认语言（可选，默认为 'en'）

与 MCP 客户端一起使用

将其添加到您的 MCP 客户端配置（例如 Claude Desktop）：

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

与 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", "@modelcontextprotocol/server-youtube"],
        "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", "@modelcontextprotocol/server-youtube"],
      "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: "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"
});

开发

# 安装依赖项
npm install

# 运行测试
npm test

# 构建
npm run build

# 代码检查
npm run lint

贡献

有关为此存储库做出贡献的信息，请参阅 CONTRIBUTING.md。

许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。# YouTube MCP 服务器

使用模型上下文协议的 YouTube API 集成。

设置

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 将 .env.example 复制到 .env：

   cp .env.example .env
   

4. 编辑 .env 并添加您的 YouTube API 密钥
5. 启动服务器：

   npm start
   

环境变量

• YOUTUBE_API_KEY: 您的 YouTube Data API v3 密钥（从 Google Cloud Console 获取）

开发

1. 要在具有自动重新加载的开发模式下运行：

   npm run dev
   

2. 构建：

   npm run build
   

安全提示

始终确保您的 API 密钥安全，切勿将其提交到版本控制。