YouTube MCP Server

YouTube MCP 服务

一个使用 YouTube Data API 实现的 Model Context Protocol（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

手动安装

# Install from npm
npm install youtube-data-mcp-server

# Or clone repository
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 密钥

开发

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

网络配置

该服务开放以下端口用于通信：

• HTTP：3000
• gRPC：3001

系统要求

• Node.js 18.0.0 或更高版本

安全注意事项

• 始终妥善保管 API 密钥，切勿将其提交到版本控制系统
• 通过环境变量或配置文件管理 API 密钥
• 为 API 密钥设置使用限制，防止未经授权的使用

许可证

本项目采用 MIT License 授权。详情请参阅 LICENSE 文件。