金大哥 - icraft2170_youtube-data-mcp-server MCP 详情

article

README

🚀 YouTube MCP 服务器

一个基于 YouTube 数据 API 实现的 Model Context Protocol (MCP) 服务器。它允许人工智能语言模型通过统一接口与 YouTube 内容交互，为 AI 与 YouTube 数据的交互提供了便捷途径。

🚀 快速开始

若你想快速搭建并使用该服务器，可以参考后续的安装和开发指南部分，按照步骤操作即可让服务器正常运行。

✨ 主要特性

视频信息

📺 获取视频详细信息（标题、描述、时长、统计数据）
🔍 根据关键词搜索视频
🔗 获取特定视频的相关视频
📊 计算并分析视频互动比例

字幕管理

📝 获取多语言支持的视频字幕
🌐 指定字幕的语言偏好
⏱️ 获取时间戳字幕以进行精确内容引用

频道分析

📈 查看频道详细统计信息（订阅数、观看次数、视频数量）
🔥 获取频道的高播放量视频
📊 分析频道增长和互动指标

趋势分析

🌟 查看按区域和类别划分的热门视频
📊 比较多个视频的性能指标
🚀 发现特定类别的流行内容

📦 安装指南

通过 Smithery 的自动安装

使用 Smithery 自动安装：

# 示例命令

环境配置

YouTube API 设置

创建项目：前往 Google Cloud Console 创建新项目。
启用 YouTube Data API v3：在 APIs & Services 部分启用 YouTube Data API v3。
获取密钥：转到 Credentials，创建新的 API 密钥（JSON）。
配置环境变量：

export YOUTUBE_API_KEY="你的API密钥"

MCP 客户端配置

在 config.json 中添加以下内容：

{
  "youtube": {
    "api_key": "your_api_key_here"
  }
}

📚 详细文档

提供的工具

该服务器提供以下 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（数组） |

开发指南

克隆仓库

git clone https://github.com/yourusername/youtube-mcp-server.git
cd youtube-mcp-server

安装依赖

npm install

启动服务器

node index.js

网络配置

监听端口

在 config.json 中指定服务器监听的端口：

{
  "server": {
    "port": 3000
  }
}

跨域设置

启用跨域资源共享：

app.use(cors());

系统要求

Node.js: v14 或更高版本
npm: v6 或更高版本

安全注意事项

API 密钥管理：
- ⚠️ 避免将 API 密钥提交到版本控制系统。
- 💡 使用环境变量存储密钥。
网络安全：
- ⚠️ 配置防火墙限制访问。
- 💡 使用 HTTPS 提供服务。

📄 许可证

项目采用 MIT License 许可证。

icraft2170_youtube-data-mcp-server