🚀 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 字幕抓取器