内容
# 🎬 YouTube MCP 服务器：云flare Workers 上的远程 MCP
一款强大的模型上下文协议（MCP）服务器，为 AI 助手提供全面的 YouTube 分析和频道管理功能。使用 TypeScript 构建，在 Cloudflare Workers 上部署，并使用 [Google OAuth](https://github.com/cloudflare/ai/tree/main/demos/remote-mcp-google-oauth) 保护。
## ✨ 功能
### 📊 **YouTube 分析**
- **频道表现**: 收入、浏览量、订阅者增长、参与度指标
- **视频分析**: 深入的性能分析，包括留存率和流量来源
- **受众洞察**: 人口统计、地理位置、设备使用和观看模式
- **最佳内容**: 通过浏览量、收入或参与度找出表现最佳的视频
### 🎯 **内容策略工具**
- **趋势分析**: 基于当前趋势的 AI 驱动的内容建议
- **竞争对手情报**: 分析竞争对手的频道并找出内容空白
- **性能优化**: 根据您的频道数据提供建议
### 🔍 **YouTube 数据访问**
- **视频搜索**: 使用高级过滤器搜索 YouTube 上的视频
- **频道信息**: 获取详细的频道统计数据和最近的上传记录
- **视频详情**: 全面的元数据、统计数据和参与度数据
## 🛠️ 快速入门
### 先决条件
- 具有已上传内容的 YouTube 频道
- 启用了 YouTube API 的 Google Cloud Console 项目
- Cloudflare Workers 账户
### 1. 克隆和安装
```bash
git clone https://github.com/lauragift21/youtube-mcp-server.git
cd youtube-mcp-server
npm install
```
### 2. 配置 OAuth
1. **创建 Google OAuth 凭证**:
- 访问 [Google Cloud Console](https://console.cloud.google.com/)
- 启用 YouTube Data API v3 和 YouTube Analytics API
- 创建 OAuth 2.0 凭证（Web 应用程序）
- 添加重定向 URI：`https://your-worker.workers.dev/callback`
2. **设置环境变量**:
```bash
npx wrangler secret put GOOGLE_OAUTH_CLIENT_ID
npx wrangler secret put GOOGLE_OAUTH_CLIENT_SECRET
npx wrangler secret put COOKIE_ENCRYPTION_KEY
```
您可以使用随机字符串生成 `COOKIE_ENCRYPTION_KEY`
### 3. 部署
```bash
npx wrangler deploy
```
### 连接到 Claude Desktop
将以下内容添加到您的 Claude Desktop 配置中：
```json
{
"mcpServers": {
"youtube-mcp-server": {
"command": "npx",
"args": [
"mcp-remote",
"https://your-deployment.workers.dev/sse"
]
}
}
}
```
### 连接到 Cloudflare AI Playground
您可以通过 Cloudflare AI Playground 连接您的 MCP 服务器，这是一个远程 MCP 客户端：
- 访问 https://playground.ai.cloudflare.com/
- 输入您部署的 MCP 服务器 URL（remote-mcp-server-authless.<your-account>.workers.dev/sse）
- 现在您可以在 Playground 中直接使用您的 MCP 工具！
## 🔧 可用工具
### 分析工具
- `youtube_getChannelAnalytics` - 获取频道性能指标
- `youtube_analyzeVideoPerformance` - 深入了解视频性能
- `youtube_getTopVideos` - 查找表现最佳的内容
- `youtube_getAudienceDemographics` - 了解您的观众
### 内容策略工具
- `youtube_suggestContentIdeas` - AI 驱动的主题建议
- `youtube_analyzeCompetitors` - 竞争对手分析和基准测试
### 数据工具
- `youtube_searchVideos` - 使用高级过滤器搜索 YouTube
- `youtube_getVideoDetails` - 获取全面的视频信息
- `youtube_getChannelInfo` - 频道概览和统计数据
- `youtube_getChannelVideos` - 任何频道的最近上传记录
## 💡 示例查询
在 Claude Desktop 上尝试这些问题：
### **📈 频道分析**
> *"显示我过去 30 天的 YouTube 频道表现"*
### **🎯 内容策略**
> *"我应该制作什么样的视频来在 AI/科技领域获得更多关注？*"*
> *"分析我的竞争对手并显示我错失的内容机会"*
### **👥 受众洞察**
> *"谁是我的观众？显示人口统计和地理数据"*
## 🏗️ 架构
```
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Claude Desktop │────│ MCP 服务器 │────│ YouTube API │
│ (MCP 客户端) │ │ (Cloudflare) │ │ (Google) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
┌──────────────────┐
│ OAuth 提供商 │
│ (Google Auth) │
└──────────────────┘
```
### 关键组件
- **MCP 服务器**: 处理工具请求和 API 通信
- **OAuth 提供商**: 管理 Google 身份验证和令牌刷新
- **YouTube 数据 API**: 公共视频和频道信息
- **YouTube 分析 API**: 私有频道分析和收入数据
## 🔗 链接
- **[模型上下文协议](https://modelcontextprotocol.io/)** - 了解 MCP
- **[YouTube 数据 API](https://developers.google.com/youtube/v3)** - YouTube API 文档
- **[Cloudflare Workers](https://workers.cloudflare.com/)** - 无服务器部署平台
- **[Claude Desktop](https://claude.ai/desktop)** - 支持 MCP 的 AI 助手
---
**由 [Gift Egwuenu](https://github.com/lauragift21) 构建 | 由 MCP 和 Cloudflare Workers 提供支持**
