YouTube MCP 服务器

一个集成 YouTube 的媒体控制协议 (MCP) 服务器，允许您跨多个设备控制 YouTube 播放。

功能

• 从任何设备播放、暂停并控制 YouTube 视频
• 同步多个客户端的播放状态
• 直接从界面搜索 YouTube 视频
• 控制音量和播放位置
• 使用 WebSocket 实现实时更新
• 简单直观的用户界面

安装

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 服务器为您提供一个跨多个设备控制 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/               # 客户端文件
│   ├── index.html        # 主 HTML 文件
│   ├── app.js            # 客户端 JavaScript
│   └── styles.css        # CSS 样式
├── server.js             # 服务器主文件
├── package.json          # 依赖项和脚本
└── .env                  # 环境变量（基于 .env.example 创建）

需求

• Node.js (v14 或更高版本)
• npm (v6 或更高版本)
• 一个 YouTube Data API 密钥

定制化

您可以根据需要自定义服务器：

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

故障排除

• 如果无法启动服务器，请检查 Node.js 和 npm 是否已正确安装。
• 如果遇到连接问题，请确保服务器正在运行且端口开放。
• 如需帮助，请参考文档或联系支持团队。