Scan to contactREADME
🚀 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 许可证。