YouTube MCP Server

YouTube MCP Server

一个用于集成 YouTube 的媒体控制协议（MCP）服务，可让你在多台设备上控制 YouTube 播放。

功能

• 在任意设备上播放、暂停和控制 YouTube 视频
• 在多个客户端之间同步播放
• 直接在界面中搜索 YouTube 视频
• 控制音量和播放进度
• 使用 WebSockets 实时更新
• 简洁直观的用户界面

安装

1. 克隆此仓库：

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

2. 安装依赖项：

   npm install
   

3. 根据 .env.example 模板创建 .env 文件：

   cp .env.example .env
   

4. 编辑 .env 文件并添加你的 YouTube API 密钥：

   YOUTUBE_API_KEY=your_youtube_api_key_here
   

   你可以从 Google Cloud Console 获取 YouTube API 密钥：

   • 创建新项目
   • 启用 YouTube Data API v3
   • 创建 API 凭据（API Key）

使用方法

1. 启动服务：

   npm start
   

2. 如需在开发过程中自动重启：

   npm run dev
   

3. 打开浏览器并访问：

   http://localhost:3000
   

工作原理

YouTube MCP Server 为多台设备上的 YouTube 播放提供了一个集中控制点。它使用：

• Express.js 作为 HTTP 服务和 API 端点
• Socket.io 实现客户端之间的实时通信
• YouTube Data API 搜索视频并获取视频信息
• YouTube IFrame API 控制视频播放

客户端连接到服务后：

1. 可以使用搜索功能查找视频
2. 在自己的设备上播放视频
3. 控制播放（播放、暂停、跳转、音量）
4. 所有命令都会广播给其他已连接的客户端
5. 客户端可以同步当前播放状态

API 端点

• GET /api/video/:videoId - 获取视频信息
• GET /api/search?q=query - 搜索 YouTube 视频
• GET /api/clients - 获取已连接客户端列表

WebSocket 事件

客户端到服务端

• play - 播放视频
• pause - 暂停当前视频
• stop - 停止播放
• seek - 跳转到指定位置
• volume - 调节音量
• mute - 静音/取消静音
• updateTimestamp - 更新当前播放进度

服务端到客户端

• playerStateUpdate - 向所有客户端广播播放器状态更新

项目结构

youtube-mcp-server/
├── public/               # Client-side files
│   ├── index.html        # Main HTML file
│   ├── app.js            # Client-side JavaScript
│   └── styles.css        # CSS styles
├── server.js             # Main server file
├── package.json          # Dependencies and scripts
└── .env                  # Environment variables (create from .env.example)

要求

• Node.js（v14 或更高版本）
• npm（v6 或更高版本）
• YouTube Data API 密钥

自定义

你可以通过以下方式自定义服务：

1. 修改 public 目录中的 UI
2. 在 server.js 中添加其他 API 端点
3. 扩展 Socket.io 事件处理程序以实现更多功能

故障排除

常见问题：

• API 密钥错误：确保已在 .env 文件中正确设置 YouTube API 密钥
• 连接问题：确保防火墙允许通过指定端口建立连接
• 视频播放问题：部分视频的所有者可能已禁用嵌入功能

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。