Yt Description MCP

🚀 YouTube 轉錄提取器 MCP 🎥

YouTube轉錄提取器MCP是一個基於模型上下文協議（MCP）構建的服務器，它允許AI助手直接從YouTube視頻中提取字幕。該工具專為與Cursor和Claude Desktop集成而設計，能讓AI分析並直接處理YouTube視頻內容，極大提升了對視頻內容的利用效率。

🚀 快速開始

本工具能讓AI直接處理YouTube視頻內容，以下為你介紹使用前的準備和操作步驟。

✨ 主要特性

• 🎯 可從任何公開的YouTube視頻中提取字幕，方便獲取視頻文字信息。
• 🔌 能與Cursor和Claude Desktop輕鬆集成，拓展AI工具的視頻處理能力。
• 🚀 使用TypeScript實現類型安全，保障開發和運行的穩定性。
• 📦 具備簡單的安裝和部署流程，降低使用門檻。
• 🛠️ 基於模型上下文協議構建，確保與其他系統的兼容性。

📦 安裝指南

先決條件

• Node.js（v16或更高版本）
• pnpm（推薦）或npm
• 一個用於提取字幕的YouTube視頻鏈接

安裝步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/yt-mcp.git
cd yt-mcp

2. 安裝依賴項：

pnpm install

3. 構建項目：

pnpm run build

📚 詳細文檔

配置

對於Cursor

1. 打開Cursor設置。
2. 進入MCP → 添加新的MCP服務器。
3. 使用以下配置：
   • 名稱：youtube-transcript
   • 類型：命令
   • 命令：node /絕對路徑/to/yt-mcp/build/index.js

對於Claude Desktop

將以下配置添加到你的Claude Desktop配置文件中：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": ["/絕對路徑/to/yt-mcp/build/index.js"]
    }
  }
}

使用方法

完成配置後，AI可以通過傳遞視頻鏈接來提取字幕。示例：

// AI會使用此格式在內部調用
const transcript = await extractTranscript({
  input: "https://www.youtube.com/watch?v=VIDEO_ID"
});

技術細節

服務器使用以下技術構建：

• @modelcontextprotocol/sdk - 用於MCP實現。
• youtube-transcript - 用於字幕提取。
• TypeScript - 提供類型安全和更好的開發體驗。

侷限性

• 只能處理公開的YouTube視頻。
• 視頻必須啟用了字幕功能。
• 部分視頻可能使用自動生成的字幕，準確性可能會有所折扣。

常見問題修復

1. “無法找到視頻ID”錯誤
   • 確保YouTube鏈接完整且正確。
   • 檢查視頻是否公開可訪問。
2. “無字幕可用”錯誤
   • 驗證視頻是否啟用了字幕功能。
   • 嘗試其他視頻以確認工具正常工作。
3. 構建錯誤
   • 確保所有依賴項已安裝。
   • 檢查Node.js版本（應為v16或更高）。

貢獻

歡迎貢獻！請隨意提交Pull Request。對於重大更改，請先打開問題討論您想要修改的內容。

📄 許可證

本項目採用MIT許可證。