AI导哈

YouTube数据MCP服务器

一个利用YouTube数据API实现的模型上下文协议（MCP）服务器，为AI语言模型提供与YouTube内容交互的标准化接口。

  • by icraft2170
  • JavaScript
  • 本地部署
  • 65 星标
  • 更新于
在 GitHub 查看 icraft2170/youtube-data-mcp-server

使用说明

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自动安装

通过以下方式为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数据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. 访问谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 启用YouTube数据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文件。

相关 MCP