Youtube Knowledge MCP

🚀 YouTube Knowledge MCP

這是一個可投入生產使用的模型上下文協議（MCP）服務器，它能將YouTube轉變為一個可查詢的知識源。你可以在其中進行搜索、獲取詳情、分析視頻字幕和評論，還能借助可選的大語言模型（LLM）來驅動人工智能工作流。該項目專為Claude Desktop和其他MCP客戶端打造。

🚀 快速開始

YouTube Knowledge MCP 是一個強大的工具，能讓你以更智能的方式利用 YouTube 上的知識。以下是使用該項目的基本步驟。

✨ 主要特性

• 快速且支持配額管理：通過緩存機制實現快速的YouTube API訪問。
• 集成豐富工具：提供搜索、獲取詳情、熱門視頻、頻道搜索等工具。
• 可選的AI能力：藉助OpenAI/Anthropic等AI服務，可實現視頻內容總結、主題分析、章節生成、學習路徑規劃、評論意圖分析和知識圖譜構建等功能。
• 零干擾：配置簡單，日誌清晰，默認設置安全可靠。

📦 安裝指南

環境要求

• Node.js 18 及以上版本
• YouTube Data API v3 密鑰
• 可選：用於AI工具的OpenAI和/或Anthropic API密鑰

安裝依賴

npm install

配置環境變量

創建 .env 文件（或者在你的MCP客戶端配置中設置變量）。你可以從示例文件開始：

cp env.example .env

然後在 .env 中設置相應的值：

# 必需
YOUTUBE_API_KEY=your_youtube_api_key

# 可選的AI提供商（啟用AI工具：分析視頻內容、生成學習路徑、分析評論意圖、簡化視頻字幕、生成視頻章節、生成知識圖譜）
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key

# 可選調整
LOG_LEVEL=info
MAX_DAILY_QUOTA=8000
REDIS_URL= # 例如 redis://localhost:6379
REDIS_HOST=
REDIS_PORT=
REDIS_PASSWORD=

項目提供了帶有佔位符的 env.example 文件。注意，不要將你的 .env 文件提交到版本控制系統。

構建和運行

# 開發模式（即時監聽文件變化）
npm run dev

# 生產模式
npm run build
npm start

連接到Claude Desktop（示例）

在Claude Desktop配置中添加絕對路徑：

{
  "mcpServers": {
    "youtube-knowledge": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-knowledge-mcp/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key",
        "OPENAI_API_KEY": "optional_openai",
        "ANTHROPIC_API_KEY": "optional_anthropic",
        "LOG_LEVEL": "info"
      }
    }
  }
}

編輯配置後，重啟Claude Desktop。

💻 使用示例

基礎用法

項目提供了一系列可用的工具，以下是部分工具的簡單介紹：

• youtube_search：可帶過濾條件搜索視頻。
• get_video_details：獲取視頻元數據、字幕（盡力獲取）和評論。
• get_trending_videos：按地區或類別獲取熱門視頻。
• search_channels：可帶統計信息搜索頻道。

高級用法

如果配置了AI提供商密鑰，還能使用以下高級AI工具：

• analyze_video_content：進行AI主題分析、情感分析、問題提取、內容總結和關鍵詞提取。
• generate_learning_path：生成特定主題的AI學習路徑。
• analyze_comment_intents：對觀眾評論意圖進行分類。
• simplify_video_transcript：以簡單易懂的方式簡化視頻字幕。
• generate_video_chapters：生成帶時間戳的AI視頻章節。
• generate_knowledge_graph：構建跨視頻的概念知識圖譜。

🔧 技術細節

配額和安全

• 實施每日配額限制（默認8000單位），並支持成本感知的AI使用。
• 日誌輸出到標準錯誤輸出（不會干擾MCP的標準輸入輸出）。
• 緩存機制可減少API調用和令牌消耗，支持可選的Redis緩存。

故障排除

• 缺少密鑰：確保已設置 YOUTUBE_API_KEY。
• 配額超限：降低使用頻率、啟用緩存或提高 MAX_DAILY_QUOTA。
• Claude無法連接：驗證 build/index.js 的絕對路徑並重啟。

📄 許可證

本項目採用MIT許可證。 作者：Efi Kuta