youtube-data-mcp-server

🚀 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 设置

1. 访问 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用 YouTube Data API v3
4. 创建密钥并设置环境变量 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 工具，以充分发挥服务器的功能。