Youtube MCP Server

🚀 YouTube MCP 服務器

這個 YouTube MCP 服務器是一個實用工具，基於模型上下文協議（MCP），能與 YouTube 數據 API 和字幕抓取器交互。藉助它，用戶可通過統一接口輕鬆訪問視頻信息和字幕數據。

🚀 快速開始

YouTube MCP 服務器允許你通過統一接口訪問視頻信息和字幕數據。下面將為你介紹如何快速上手使用該服務器。

✨ 主要特性

• 📺 獲取視頻詳細信息
• 📝 提取字幕
• 🔍 搜索相關視頻
• 📊 分析內容
• 📄 支持多種格式輸出

📦 安裝指南

方式一：使用 npm

npm install youtube-mcp-server

方式二：從源代碼構建

1. 克隆倉庫：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 安裝依賴項：

   npm install
   

3. 啟動服務器：

   npm start
   

💻 使用示例

基礎用法

初始化 MCP 代理

const { MCP } = require('youtube-mcp-server');
const mcp = new MCP({
  apiKey: 'your_api_key', // 替換為你的 YouTube API 密鑰
  models: ['gpt-3.5-turbo'] // 支持的模型列表
});

獲取視頻信息

async function getVideoInfo(videoId) {
  try {
    const result = await mcp.query({
      type: 'query',
      query: {
        video: {
          id: videoId
        }
      }
    });
    return result;
  } catch (error) {
    console.error('獲取視頻信息失敗:', error.message);
    return null;
  }
}

提取字幕

async function extractSubtitles(videoId, language = 'zh-CN') {
  try {
    const result = await mcp.query({
      type: 'extract',
      extractor: {
        youtube: {
          videoId,
          language
        }
      }
    });
    return result;
  } catch (error) {
    console.error('提取字幕失敗:', error.message);
    return null;
  }
}

高級用法

視頻信息查詢

const videoInfo = await getVideoInfo('dQw4w9WgXcQ');
console.log(videoInfo);
// 輸出示例：
// {
//   id: 'dQw4w9WgXcQ',
//   title: '什麼是什麼？', // 示例標題
//   channel: 'PewDiePro', // 示例頻道名稱
//   views: '100萬', // 示例觀看次數
//   likes: '10萬' // 示例點贊數
// }

字幕提取與分析

const subtitles = await extractSubtitles('dQw4w9WgXcQ');
console.log(subtitles);
// 輸出示例：
// [
//   {
//     timestamp: '00:01:23', // 示例時間戳
//     text: '這是第一個字幕條。' // 示例字幕文本
//   },
//   ...
// ]

📚 詳細文檔

錯誤處理

該服務器處理多種錯誤情況，包括：

• ⚠️ 無效的 API 密鑰
• ⚠️ 視頻或頻道未找到
• ⚠️ 字幕不可用
• ⚠️ 網絡問題

📄 許可證

本項目採用 MIT 許可協議。

👏 致謝

感謝以下項目和庫的支持：

• 模型上下文協議 TypeScript SDK
• YouTube 數據 API
• YouTube 字幕抓取器