Youtube MCP

🚀 YouTube MCP 服務器

YouTube MCP 服務器是一個用於與 YouTube 視頻交互的模型上下文協議（MCP）服務器。它可以提取視頻元數據、字幕，將其轉換為 Markdown 格式，並使用各種模板進行展示。

🚀 快速開始

YouTube MCP 服務器為用戶提供了與 YouTube 視頻進行交互的便捷途徑。它具備豐富的功能，如獲取視頻元數據、提取字幕等，能滿足不同場景的需求。

✨ 主要特性

• 視頻元數據：可獲取全面的視頻信息。
• 字幕提取：支持自動生成和人工添加的字幕。
• 多語言支持：內置英語和法語。
• 模版系統：有三個內置 Markdown 模板：
  • 基本：簡單的文字記錄格式。
  • 詳細：完整的元數據與時間戳。
  • 搜索：結果高亮並附帶上下文。
• 搜索功能：可在視頻字幕中進行搜索。
• 靈活的身份驗證：支持 API 密鑰和 OAuth2 身份驗證。

📦 安裝指南

先決條件

• Node.js（v16 或更高版本）
• npm 或 yarn
• YouTube 數據 API 密鑰和/或 OAuth2 憑證

安裝步驟

1. 克隆倉庫：

git clone [倉庫地址]
cd youtube-mcp

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

📚 詳細文檔

配置

在根目錄下創建一個 .env 文件，添加您的 YouTube 憑證：

YOUTUBE_API_KEY=你的API密鑰
YOUTUBE_CLIENT_ID=你的客戶端ID
YOUTUBE_CLIENT_SECRET=你的客戶端密碼
YOUTUBE_REFRESH_TOKEN=你的刷新令牌  # 可選，用於OAuth2

MCP 配置

將服務器添加到您的 MCP 設置文件中（通常位於 ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["path/to/youtube-mcp/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "你的API密鑰",
        "YOUTUBE_CLIENT_ID": "你的客戶端ID",
        "YOUTUBE_CLIENT_SECRET": "你的客戶端密碼"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

使用方法

該服務器提供以下工具：

基礎用法

// 獲取視頻信息
use_mcp_tool youtube get_video_info {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID"
}

// 獲取字幕
use_mcp_tool youtube get_transcript {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID"
}

高級用法

// 提供反饋
use_mcp_tool youtube provide_feedback {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "transcript_id": "TRANSSCRIPT_ID",
  "feedback": "FEEDBACK_MESSAGE"
}

依賴項

• 開發依賴項：
  • typescript@^5.0.2
  • @types/node@>=16.0.0
  • dotenv@^16.3.1
  • openai@^7.0.4

OAuth2 設置

要配置 OAuth2，請按照以下步驟操作：

1. 在 Google Cloud Console 創建項目並啟用 YouTube API。
2. 創建 OAuth2 客戶端 ID，並獲取 CLIENT_ID 和 CLIENT_SECRET。
3. 使用您的項目名稱替換 PROJECT_NAME。

自定義模板

要在 dist 文件夾中生成自定義模板：

1. 在根目錄下創建一個 templates 文件夾。
2. 將所需的 Markdown 模板文件放入其中。

📄 許可證

項目使用 MIT 許可證。

🔧 貢獻指南

要貢獻代碼，請按照以下步驟操作：

1. Fork 倉庫。
2. 在本地克隆您的 fork。
3. 創建功能分支：git checkout -b feature/your-feature-name
4. 提交更改：git commit -m '添加你的特性'
5. 推送到分支：git push origin feature/your-feature-name
6. 創建 Pull Request。

將此文檔複製並粘貼到您的項目中，確保所有內容完整無誤。