YouTube MCP 服务器

这是一个利用YouTube数据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自动安装YouTube MCP服务器到Claude桌面：

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数据API密钥（必需）
• YOUTUBE_TRANSCRIPT_LANG: 默认字幕语言（可选，默认值：'ko'）

MCP客户端配置

在您的Claude桌面配置文件中添加以下内容：

{
  "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控制台
2. 创建一个新项目或选择现有项目
3. 启用YouTube数据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文件。