🚀 YouTube MCP 服务器

YouTube MCP 服务器是一个用于与 YouTube 视频交互的模型上下文协议（MCP）服务器。它可以提取视频元数据、字幕，将其转换为 Markdown 格式，并使用各种模板进行展示。

🚀 快速开始

YouTube MCP 服务器为用户提供了与 YouTube 视频进行交互的便捷途径。它具备丰富的功能，如获取视频元数据、提取字幕等，能满足不同场景的需求。

✨ 主要特性

• 视频元数据：可获取全面的视频信息。
• 字幕提取：支持自动生成和人工添加的字幕。
• 多语言支持：内置英语和法语。
• 模版系统：有三个内置 Markdown 模板：
  • 基本：简单的文字记录格式。
  • 详细：完整的元数据与时间戳。
  • 搜索：结果高亮并附带上下文。
• 搜索功能：可在视频字幕中进行搜索。
• 灵活的身份验证：支持 API 密钥和 OAuth2 身份验证。

📦 安装指南

先决条件

• Node.js（v16 或更高版本）
• npm 或 yarn
• YouTube 数据 API 密钥和/或 OAuth2 凭证

安装步骤

1. 克隆仓库：

git clone [仓库地址]
cd youtube-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

📚 详细文档

配置

在根目录下创建一个 .env 文件，添加您的 YouTube 凭证：

YOUTUBE_API_KEY=你的API密钥
YOUTUBE_CLIENT_ID=你的客户端ID
YOUTUBE_CLIENT_SECRET=你的客户端密码
YOUTUBE_REFRESH_TOKEN=你的刷新令牌  # 可选，用于OAuth2

MCP 配置

将服务器添加到您的 MCP 设置文件中（通常位于 ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["path/to/youtube-mcp/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "你的API密钥",
        "YOUTUBE_CLIENT_ID": "你的客户端ID",
        "YOUTUBE_CLIENT_SECRET": "你的客户端密码"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

使用方法

该服务器提供以下工具：

基础用法

// 获取视频信息
use_mcp_tool youtube get_video_info {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID"
}

// 获取字幕
use_mcp_tool youtube get_transcript {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID"
}

高级用法

// 提供反馈
use_mcp_tool youtube provide_feedback {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "transcript_id": "TRANSSCRIPT_ID",
  "feedback": "FEEDBACK_MESSAGE"
}

依赖项

• 开发依赖项：
  • typescript@^5.0.2
  • @types/node@>=16.0.0
  • dotenv@^16.3.1
  • openai@^7.0.4

OAuth2 设置

要配置 OAuth2，请按照以下步骤操作：

1. 在 Google Cloud Console 创建项目并启用 YouTube API。
2. 创建 OAuth2 客户端 ID，并获取 CLIENT_ID 和 CLIENT_SECRET。
3. 使用您的项目名称替换 PROJECT_NAME。

自定义模板

要在 dist 文件夹中生成自定义模板：

1. 在根目录下创建一个 templates 文件夹。
2. 将所需的 Markdown 模板文件放入其中。

📄 许可证

项目使用 MIT 许可证。

🔧 贡献指南

要贡献代码，请按照以下步骤操作：

1. Fork 仓库。
2. 在本地克隆您的 fork。
3. 创建功能分支：git checkout -b feature/your-feature-name
4. 提交更改：git commit -m '添加你的特性'
5. 推送到分支：git push origin feature/your-feature-name
6. 创建 Pull Request。

将此文档复制并粘贴到您的项目中，确保所有内容完整无误。