Youtube MCP

🚀 YouTube MCP

一個用於YouTube視頻分析的模型上下文協議（MCP）服務器，為用戶提供獲取字幕、總結內容和使用Gemini AI查詢視頻的實用工具，助力高效分析YouTube視頻。

🚀 快速開始

本項目是一個用於YouTube視頻分析的模型上下文協議（MCP）服務器，藉助它可獲取字幕、總結內容並使用Gemini AI查詢視頻。

✨ 主要特性

• 📝 字幕提取：從YouTube視頻中獲取詳細的字幕
• 📊 視頻摘要：利用Gemini AI生成簡潔的視頻摘要
• ❓ 自然語言查詢：對視頻內容提出問題
• 🔍 YouTube搜索：查找與特定查詢匹配的視頻
• 💬 評論分析：檢索並分析視頻評論

📦 安裝指南

先決條件

• Python 3.9+
• Google Gemini API密鑰
• YouTube Data API密鑰

本地運行

通過Smithery安裝

要自動從Claude Desktop安裝youtube - mcp，請使用Smithery：

npx -y @smithery/cli install @Prajwal-ak-0/youtube-mcp --client claude

選項1：直接從smithery安裝

選項2：本地設置

1. 克隆倉庫：

git clone https://github.com/Prajwal-ak-0/youtube-mcp
cd youtube-mcp

2. 創建虛擬環境並安裝依賴項：

python -m venv .venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
pip install -e .

3. 創建包含API密鑰的.env文件：

GEMINI_API_KEY=your_gemini_api_key
YOUTUBE_API_KEY=your_youtube_api_key

4. 運行MCP服務器

mcp dev main.py

打開Stdio進行訪問

或者

6. 配置Go cursor或windsurf，使用以下JSON內容：

{
  "youtube": {
    "command": "uv",
    "args": [
      "--directory",
      "/absolute/path/to/youtube-mcp",
      "run",
      "main.py",
      "--transport",
      "stdio",
      "--debug"
    ]
  }
}

💻 使用示例

基礎用法

本項目提供了一系列實用工具，以下是部分工具的使用示例：

# 獲取視頻字幕
youtube/get-transcript 

# 生成視頻摘要
youtube/summarize 

# 對視頻內容進行提問
youtube/query 

# 搜索YouTube視頻
youtube/search 

# 檢索視頻評論
youtube/get-comments 

# 獲取視頻點贊數
youtube/get-likes 

🔧 技術細節

本項目是一個模型上下文協議（MCP）服務器，用於YouTube視頻分析。它依賴Python 3.9+環境，同時需要Google Gemini API密鑰和YouTube Data API密鑰。通過這些API，項目實現了字幕提取、視頻摘要生成、自然語言查詢、YouTube搜索以及評論分析等功能。在本地運行時，可通過Smithery自動安裝，也可手動克隆倉庫、創建虛擬環境、安裝依賴項並配置API密鑰。項目還提供了一系列可用工具，方便用戶對YouTube視頻進行各種操作。

📚 詳細文檔

可用工具

• youtube/get-transcript：獲取視頻字幕
• youtube/summarize：生成視頻摘要
• youtube/query：對視頻內容進行提問
• youtube/search：搜索YouTube視頻
• youtube/get-comments：檢索視頻評論
• youtube/get-likes：獲取視頻點贊數

🤝 貢獻

歡迎貢獻！請隨意提交Pull Request。