YouTube MCP 服务器

smithery 徽章

一个利用 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 自动为 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 数据 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 设置

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

开发

# 安装依赖
npm install

# 以开发模式运行
npm run dev

# 构建
npm run build

网络配置

服务器暴露以下端口用于通信：

HTTP: 3000
gRPC: 3001

系统要求

Node.js 18.0.0 或更高版本

安全注意事项

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

许可证

本项目根据 MIT 许可证授权。详情请参阅 LICENSE 文件。