Youtube MCP

🚀 YouTube MCP 服务器

YouTube MCP 服务器是一个用于与 YouTube 视频交互的模型上下文协议（MCP）服务器。它能够提取视频元数据、字幕，将其转换为 Markdown 格式，并通过各种模板进行展示，为用户提供了便捷的视频信息处理方式。

✨ 主要特性

• 视频元数据：可获取全面的视频信息，让您对视频有更深入的了解。
• 字幕提取：支持自动生成和人工添加的字幕，满足不同场景的需求。
• 多语言支持：内置英语和法语，方便不同语言背景的用户使用。
• 模版系统：拥有三个内置 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。

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