Youtube MCP Server 66a

一个用于YouTube集成的媒体控制协议服务器，支持多设备同步播放控制，提供视频搜索、播放控制、实时同步等功能。

娱乐与媒体教育与学习工具 #YouTube控制 #多设备同步 #实时通信 #播放管理 .JavaScript

评分 : 2分

下载量 : 5.5K

更新时间 : 2025-04-23

打开站点

什么是YouTube MCP Server?

YouTube MCP Server是一个中央控制平台，允许您通过一个界面控制多个设备上的YouTube视频播放。它就像您所有设备的遥控器，可以同步播放、暂停、调节音量等操作。

如何使用YouTube MCP Server?

只需在电脑上运行服务器，然后在任何设备的浏览器中打开控制界面。您可以搜索YouTube视频并控制所有连接的设备同步播放。

适用场景

适合家庭影院同步、多房间音频系统、教学演示或任何需要跨设备控制YouTube播放的场景。

主要功能

多设备控制

通过一个界面同时控制多个设备的YouTube播放

实时同步

所有连接的设备保持播放进度完全同步

内置搜索

直接通过界面搜索YouTube视频，无需切换应用

完整播放控制

支持播放/暂停、跳转、音量调节和静音功能

优势

无需额外硬件，使用现有设备即可

简单易用的网页界面，无需安装客户端

支持几乎所有现代浏览器和设备

开源免费，可自行部署和修改

局限性

需要稳定的网络连接

部分YouTube视频可能因版权限制无法播放

初次设置需要获取YouTube API密钥

如何使用

安装准备

确保已安装Node.js(14或更高版本)和npm

获取YouTube API密钥

访问Google Cloud Console创建项目并启用YouTube Data API

设置服务器

克隆仓库并安装依赖

配置环境变量

复制.env.example文件并添加您的API密钥

启动服务器

运行开发服务器或生产服务器

访问控制界面

在浏览器中打开http://localhost:3000

使用案例

家庭影院同步

在客厅电视和多个房间的音箱上同步播放音乐视频，保持完美同步

教学演示

在教室的多台电脑上同步播放教学视频，确保所有学生进度一致

常见问题

为什么某些视频无法播放?

最多可以连接多少设备?

如何解决延迟不同步问题?

🚀 YouTube MCP 服务器

YouTube MCP 服务器是一个集成了 YouTube 的媒体控制协议（MCP）的服务器，它能够让您在多个设备间轻松控制 YouTube 视频的播放，为跨设备视频播放控制提供了便捷的解决方案。

🚀 快速开始

要使用 YouTube MCP 服务器，您需要按照以下步骤进行操作：

克隆此仓库：

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

安装依赖项：
```
npm install
```
基于 .env.example 模板创建一个 .env 文件：
```
cp .env.example .env
```
编辑 .env 文件并在其中添加您的 YouTube API 密钥：
```
YOUTUBE_API_KEY=your_youtube_api_key_here
```
您可以从 Google Cloud Console 获得一个 YouTube API 密钥：
- 创建新项目
- 启用 YouTube Data API v3
- 创建 API 凭据（API Key）
启动服务器：
```
npm start
```
开发时使用自动重启：
```
npm run dev
```
打开浏览器并导航到：
```
http://localhost:3000
```

✨ 主要特性

支持从任何设备播放、暂停并控制 YouTube 视频，操作便捷。
能够同步多个客户端的播放状态，确保各设备间播放一致。
可直接从界面搜索 YouTube 视频，快速定位所需内容。
可以控制音量和播放位置，满足个性化观看需求。
使用 WebSocket 实现实时更新，保证信息及时同步。
拥有简单直观的用户界面，降低使用门槛。

📦 安装指南

克隆仓库

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

安装依赖

npm install

创建环境文件

cp .env.example .env

配置 API 密钥

YOUTUBE_API_KEY=your_youtube_api_key_here

您可从 Google Cloud Console 获取 YouTube API 密钥，具体步骤如下：

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

💻 使用示例

基础用法

启动服务器：

npm start

开发时使用自动重启：

npm run dev

打开浏览器并导航到：

http://localhost:3000

📚 详细文档

工作原理

YouTube MCP 服务器为您提供一个跨多个设备控制 YouTube 播放的中央控制点。它使用：

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

当客户端连接到服务器时：

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

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 创建）