Youtube MCP Server

🚀 YouTube 模型上下文協議 (MCP) 服務器

本項目提供了一個 YouTube 模型上下文協議 (MCP) 服務器，可幫助開發者通過 API 便捷地管理 YouTube 的視頻、頻道和播放列表等資源，提升開發效率。

🚀 快速開始

要使用本項目，你需要完成安裝和配置工作，下面為你詳細介紹。

📦 安裝指南

通過 Smithery 安裝

使用以下命令通過 Smithery 進行安裝：

npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude

手動安裝

1. 克隆倉庫

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

2. 安裝依賴

   npm install
   

📚 詳細文檔

配置說明

環境變量配置

• YOUTUBE_API_KEY：用於訪問 YouTube API 的密鑰。
• YOUTUBE_TRANSCRIPT_LANG（可選）：默認字幕語言，值為 "en" 時使用英文。

VS Code 插件安裝

將以下內容添加到 VS Code 的用戶設置 (JSON) 文件中：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "YouTube API Key",
        "password": true
      }
    ],
    "servers": {
      "youtube": {
        "command": "npx",
        "args": ["-y", "zubeid-hendricks/youtube-mcp-server"],
        "env": {
          "YOUTUBE_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

YouTube API 設置

1. 訪問 Google Cloud Console。
2. 創建新項目或選擇現有項目。
3. 啟用 YouTube Data API v3。
4. 創建 API 憑據並獲取密鑰。
5. 將密鑰複製到配置文件中。

💻 使用示例

基礎用法

視頻管理

// 獲取視頻詳情
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.getPlaylistItems({
  playlistId: "playlist-id",
  maxResults: 50
});

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

🔧 技術細節

開發步驟

# 安裝依賴
npm install

# 運行測試
npm test

# 構建項目
npm run build

# 檢查代碼
npm run lint

🤝 貢獻指南

請參閱 CONTRIBUTING.md 瞭解如何為該項目做出貢獻。

📄 許可證

本項目遵循 MIT 許可證，詳情請查看 LICENSE 文件。