Youtubemcp

🚀 YouTube MCP 服務器

YouTube MCP 服務器是一個模型上下文協議（MCP）服務器，它允許 AI 代理通過自然語言命令搜索和播放 YouTube 視頻。

✨ 主要特性

• searchVideos：在 YouTube 上搜索與任何查詢匹配的視頻。
• playPlaylist：在默認瀏覽器中以播放列表的形式打開視頻。

📦 安裝指南

前提條件

1. 安裝 Node.js 18+。
2. 從 Google Cloud Console 獲取 YouTube Data API v3 密鑰。

獲取 YouTube API 密鑰

1. 訪問 Google Cloud Console。
2. 創建一個新項目（或選擇現有項目）。
3. 導航到 APIs & Services > Library。
4. 搜索 “YouTube Data API v3” 並啟用它。
5. 轉到 APIs & Services > Credentials。
6. 點擊 Create Credentials > API Key。
7. 複製你的 API 密鑰。

安裝步驟

1. 克隆倉庫。
2. 安裝依賴項：

   npm install
   

3. 配置環境變量： 在根目錄下創建一個 .env 文件（從 .env.example 複製）：

   cp .env.example .env
   

   編輯 .env 文件並添加你的 YOUTUBE_API_KEY。
4. 構建項目：

   npm run build
   

將以下內容添加到你的 MCP 配置中（例如，.cursor/mcp.json 或 Claude Desktop 配置）：

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "node",
      "args": ["/path/to/your/project/youtubeMCP/dist/index.js"]
    }
  }
}

⚠️ 重要提示

服務器將自動從項目目錄中的 .env 文件加載 YOUTUBE_API_KEY。或者，你也可以直接在上述 JSON 配置的 env 對象中傳遞它。

💻 使用示例

配置完成後，你可以向你的 AI 代理提出以下請求：

• “在 YouTube 上搜索 10 首最佳英文歌曲”
• “播放 5 個放鬆的鋼琴音樂視頻”
• “查找泰勒·斯威夫特的歌曲並播放”
• “搜索編碼教程”

可用工具

searchVideos

通過查詢在 YouTube 上搜索視頻。 參數：

• query（字符串，必需）：搜索查詢。
• maxResults（數字，可選）：結果數量（1 - 50，默認值：10）。

playPlaylist

在瀏覽器中播放視頻。 參數：

• videoIds（字符串數組，可選）：要播放的視頻 ID 數組。
• query（字符串，可選）：搜索並播放與此查詢匹配的視頻。
• maxResults（數字，可選）：使用查詢時的視頻數量（默認值：10）。

🔧 技術細節

開發命令

# 開發模式下的監聽模式
npm run dev

# 構建
npm run build

# 啟動
npm start

項目結構

YouTubeMCP/
├── package.json
├── tsconfig.json
├── README.md
├── src/
│   ├── index.ts           # MCP 服務器入口點
│   ├── youtube-client.ts  # YouTube API 包裝器
│   └── tools/
│       ├── search.ts      # searchVideos 工具
│       └── play.ts        # playPlaylist 工具
└── dist/                  # 編譯後的 JavaScript

📄 許可證

本項目採用 MIT 許可證。