🚀 YouTube 数据 MCP 服务器
这是一个利用 YouTube 数据 API 实现的 Model Context Protocol (MCP) 服务器，允许 AI 语言模型通过标准化接口与 YouTube 内容进行交互，为数据获取和分析提供便利。
🚀 快速开始
安装
自动安装
可使用以下命令通过 Smithery 自动安装：
npx -y @smithery/cli install @icraft2170/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 密钥 | 必填 |
MCP 客户端配置
在您的项目中，需将以下路径添加到 mcp.config.js：
module.exports = {
servers: [
{
name: 'YouTube Data Server',
path: './dist/server/youtube-data-server.mjs'
}
],
// 其他配置...
}
YouTube API 设置
- 访问 Google Cloud Console
- 创建新项目或选择现有项目
- 启用 YouTube Data API v3
- 创建密钥并设置环境变量
YOUTUBE_API_KEY
开发
npm install # 安装依赖项
npm run dev # 开发服务器
✨ 主要特性
视频信息
- 获取视频详细信息（标题、描述、时长、统计数据）
- 根据关键词搜索视频
- 获取特定视频的相关视频
- 计算和分析视频互动比率
文本字幕管理
- 检索多语言支持的视频字幕
- 指定文本字幕的语言偏好
- 获取时间戳字幕以进行精确内容引用
频道分析
- 查看详细的频道统计信息（订阅数、观看次数、视频数量）
- 获取频道的热门视频
- 分析频道增长和互动指标
趋势分析
- 查看按区域和类别划分的流行视频
- 比较多个视频的性能指标
- 发现特定类别的热门内容
📦 安装指南
自动安装
使用以下命令通过 Smithery 自动安装：
npx -y @smithery/cli install @icraft2170/youtube-data-mcp-server
手动安装
克隆存储库并运行：
git clone https://github.com/icraft2170/youtube-data-mcp-server.git
cd youtube-data-mcp-server
npm install
📚 详细文档
提供的工具
该服务器提供以下 MCP 工具：
| 工具名称 | 描述 | 必填参数 |
|---|---|---|
getVideoDetails |
获取多个 YouTube 视频的详细信息，包括元数据、统计信息和内容细节 | videoIds (数组) |
searchVideos |
根据查询字符串搜索视频 | query，maxResults (可选) |
getTranscripts |
检索多个视频的文字字幕 | videoIds (数组)，lang (可选) |
getRelatedVideos |
获取与特定视频相关的 YouTube 推荐算法视频 | videoId，maxResults (可选) |
getChannelStatistics |
检索多个频道的详细指标，包括订阅数、观看次数和视频数量 | channelIds (数组) |
getChannelTopVideos |
获取特定频道中观看次数最多的视频 | channelId，maxResults (可选) |
getVideoEngagementRatio |
计算多个视频的互动指标（观看数、点赞、评论和互动比率） | videoIds (数组) |
getTrendingVideos |
获取按区域和类别划分的当前热门视频 | regionCode (可选)，categoryId (可选) |
getVideoCategories |
检索 YouTube 视频分类 | 无 |
网络配置
| 接口 | 描述 |
|---|---|
/api/video/details |
获取视频详细信息 |
/api/search/videos |
根据查询搜索视频 |
🔧 技术细节
系统要求
- Node.js 16.0 或更高版本
- npm 7.0 或更高版本
📄 许可证
该项目使用 MIT License。
⚠️ 重要提示
- 确保
YOUTUBE_API_KEY不对外公开。 - 使用 HTTPS 在生产环境中部署。
- 定期更新 API 密钥并监控异常活动。
💡 使用建议 在使用本服务器时，建议严格遵循安全注意事项，保护好 API 密钥，以确保系统的安全性和稳定性。同时，根据实际需求合理使用各项 MCP 工具，以充分发挥服务器的功能。