Youtube MCP Server 66a

一個用於YouTube集成的媒體控制協議服務器，支持多設備同步播放控制，提供視頻搜索、播放控制、即時同步等功能。

娛樂與媒體教育與學習工具 #YouTube控制 #多設備同步 #即時通信 #播放管理 .JavaScript

rating : 2 points

downloads : 17

update time : 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 創建）