YouTube MCP 服务器

一个利用 YouTube Data API 实现的模型上下文协议 (MCP) 服务器。它允许 AI 语言模型通过标准化接口与 YouTube 内容进行交互。

主要特性

视频信息

• 检索详细的视频信息（标题、描述、时长、统计数据）
• 通过关键词搜索视频
• 获取基于特定视频的相关视频
• 计算和分析视频互动率

字幕/字幕管理

• 检索具有多语言支持的视频字幕
• 指定字幕的语言偏好
• 访问带有时间戳的字幕，以便进行精确的内容参考

频道分析

• 查看详细的频道统计数据（订阅者、观看次数、视频数量）
• 获取频道中表现最佳的视频
• 分析频道增长和互动指标

趋势分析

• 按地区和类别查看热门视频
• 比较多个视频的性能指标
• 发现特定类别中的热门内容

可用工具

该服务器提供以下 MCP 工具：

工具名称	描述	必需参数
getVideoDetails	获取有关多个 YouTube 视频的详细信息，包括元数据、统计数据和内容详细信息	videoIds (数组)
searchVideos	根据查询字符串搜索视频	query, maxResults (可选)
getTranscripts	检索多个视频的字幕	videoIds (数组), lang (可选)
getRelatedVideos	根据 YouTube 的推荐算法获取与特定视频相关的视频	videoId, maxResults (可选)
getChannelStatistics	检索多个频道的详细指标，包括订阅者数量、观看次数和视频数量	channelIds (数组)
getChannelTopVideos	获取来自特定频道的观看次数最多的视频	channelId, maxResults (可选)
getVideoEngagementRatio	计算多个视频的互动指标（观看次数、点赞数、评论数和互动率）	videoIds (数组)
getTrendingVideos	按地区和类别获取当前热门视频	regionCode (可选), categoryId (可选), maxResults (可选)
compareVideos	比较多个视频的统计数据	videoIds (数组)

安装

通过 Smithery 自动安装

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

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

手动安装

# 从 npm 安装
npm install youtube-data-mcp-server

# 或克隆存储库
git clone https://github.com/icraft2170/youtube-data-mcp-server.git
cd youtube-data-mcp-server
npm install

环境配置

设置以下环境变量：

• YOUTUBE_API_KEY: YouTube Data API 密钥 (必需)
• YOUTUBE_TRANSCRIPT_LANG: 默认字幕语言 (可选, 默认: 'ko')

MCP 客户端配置

将以下内容添加到您的 Claude Desktop 配置文件：

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "youtube-data-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "YOUR_API_KEY_HERE",
        "YOUTUBE_TRANSCRIPT_LANG": "ko"
      }
    }
  }
}

YouTube API 设置

1. 访问 Google Cloud Console
2. 创建一个新项目或选择一个现有项目
3. 启用 YouTube Data API v3
4. 创建 API 凭据（API 密钥）
5. 在您的环境配置中使用生成的 API 密钥

开发

# 安装依赖
npm install

# 在开发模式下运行
npm run dev

# 构建
npm run build

网络配置

服务器公开以下端口进行通信：

• HTTP: 3000
• gRPC: 3001

系统要求

• Node.js 18.0.0 或更高版本

安全注意事项

• 始终确保您的 API 密钥安全，并且永远不要将其提交到版本控制系统
• 通过环境变量或配置文件管理您的 API 密钥
• 设置 API 密钥的使用限制以防止未经授权的使用

许可证

本项目根据 MIT 许可证获得许可。 有关详细信息，请参阅 LICENSE 文件。