Zubeidhendricks Youtube MCP Server

🚀 YouTube MCP 服務器

一個針對 YouTube 的 Model Context Protocol (MCP) 服務器實現，藉助標準化接口，讓 AI 語言模型能夠與 YouTube 內容進行交互，為 AI 應用拓展了豐富的視頻數據資源。

🚀 快速開始

本服務器使 AI 語言模型能與 YouTube 內容交互。您可通過 Smithery 自動安裝，也能手動安裝，再配置環境變量，即可在 MCP 客戶端中使用。

✨ 主要特性

視頻信息

• 獲取視頻詳細信息（標題、描述、時長等）
• 列出頻道的視頻
• 獲取視頻統計信息（觀看次數、點贊、評論）
• 搜索 YouTube 上的視頻

轉錄管理

• 獲取視頻字幕
• 支持多種語言
• 獲取時間戳字幕
• 在轉錄中搜索內容

頻道管理

• 獲取頻道詳細信息
• 列出頻道的播放列表
• 獲取頻道統計信息
• 搜索頻道內容

播放列表管理

• 列出播放列表項
• 獲取播放列表詳細信息
• 搜索播放列表中的內容
• 獲取播放列表視頻的轉錄

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 YouTube Server for Claude Desktop，可使用以下命令：

npx -y @smithery/cli install @modelcontextprotocol/server-youtube --client claude

手動安裝

npm install @modelcontextprotocol/server-youtube

📚 詳細文檔

配置

設置以下環境變量：

• YOUTUBE_API_KEY：您的 YouTube 數據 API 密鑰
• YOUTUBE_TRANSCRIPT_LANG：轉錄的默認語言（可選， defaults to 'en'）

與 MCP 客戶端配合使用

在您的 MCP 客戶端配置中添加以下內容（例如 Claude Desktop）：

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-youtube"],
      "env": {
        "YOUTUBE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

YouTube API 設置

1. 訪問 Google Cloud Console
2. 創建新項目或選擇現有項目
3. 啟用 YouTube 數據 API v3
4. 創建 API 憑據（API 密鑰）
5. 複製 API 密鑰用於配置

💻 使用示例

基礎用法

// 獲取視頻詳細信息
const video = await youtube.videos.getVideo({
  videoId: "video-id"
});

// 獲取視頻轉錄
const transcript = await youtube.transcripts.getTranscript({
  videoId: "video-id",
  language: "en"
});

// 搜索視頻
const searchResults = await youtube.videos.searchVideos({
  query: "搜索詞",
  maxResults: 10
});

高級用法

// 獲取頻道詳細信息
const channel = await youtube.channels.getChannel({
  channelId: "channel-id"
});

// 列出頻道的視頻
const videos = await youtube.channels.listVideos({
  channelId: "channel-id",
  maxResults: 50
});

// 獲取播放列表項
const playlistItems = await youtube.playlists.getItems({
  playlistId: "playlist-id"
});

// 獲取播放列表詳細信息
const playlist = await youtube.playlists.getPlaylist({
  playlistId: "playlist-id"
});

🔧 技術細節

開發

安裝依賴

npm install

運行測試

npm test

構建

npm run build

修復

npm run fix

📄 許可證

本項目遵循 MIT 協議。更多信息請查閱 LICENSE 文件。

🌟 貢獻指南

如需貢獻，請查看 CONTRIBUTING.md。