YouTube MCP Server

YouTube MCP 服务

一个用于与 YouTube 视频交互的模型上下文协议（MCP）服务。该服务提供提取视频元数据、字幕并使用各种模板将其转换为 Markdown 格式的工具。

功能

• 视频元数据：获取全面的视频信息
• 字幕提取：支持自动生成的字幕和人工字幕
• 多语言：内置支持英语和法语
• 模板系统：内置三种 Markdown 模板：
  • 基础：简单的转录文本格式
  • 详细：包含时间戳的完整元数据
  • 搜索：突出显示搜索结果并附带上下文
• 搜索功能：在视频字幕中搜索
• 灵活的身份验证：支持 API 密钥和 OAuth2 身份验证

前提条件

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

安装

1. 克隆仓库：

git clone [repository-url]
cd youtube-mcp

2. 安装依赖：

npm install

3. 构建项目：

npm run build

配置

在根目录中创建 .env 文件，并填入 YouTube 凭据：

YOUTUBE_API_KEY=your_api_key
YOUTUBE_CLIENT_ID=your_client_id
YOUTUBE_CLIENT_SECRET=your_client_secret
YOUTUBE_REFRESH_TOKEN=your_refresh_token  # Optional, for 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": "your_api_key",
        "YOUTUBE_CLIENT_ID": "your_client_id",
        "YOUTUBE_CLIENT_SECRET": "your_client_secret"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

使用方法

该服务提供以下工具：

1. 获取视频信息

use_mcp_tool youtube get_video_info {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID"
}

2. 获取字幕

use_mcp_tool youtube get_captions {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "language": "en"  // Optional, defaults to "en"
}

3. 转换为 Markdown

use_mcp_tool youtube convert_to_markdown {
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "template_name": "detailed",  // Optional, "basic", "detailed", or "search"
  "language": "en",            // Optional
  "options": {                 // Optional
    "include_chapters": true,
    "search_term": "keyword"   // Only for search template
  }
}

4. 列出模板

use_mcp_tool youtube list_templates

依赖项

{
  "dependencies": {
    "@modelcontextprotocol/sdk": "latest",
    "googleapis": "^146.0.0",
    "google-auth-library": "^9.0.0",
    "youtube-captions-scraper": "^2.0.0",
    "express": "^4.18.2",
    "open": "^9.1.0"
  },
  "devDependencies": {
    "@types/node": "^20.0.0",
    "typescript": "^5.0.0",
    "tsx": "^4.0.0"
  }
}

OAuth2 设置

对于 OAuth2 身份验证（访问私密视频时需要）：

1. 在 Google Cloud Console 中创建项目
2. 启用 YouTube Data API v3
3. 创建 OAuth2 凭据（Web 应用类型）
4. 运行身份验证脚本：

node src/get-api-key.js

5. 按照浏览器提示授权应用
6. 将刷新令牌复制到配置中

自定义模板

你可以通过修改 src/index.ts 中的 DEFAULT_TEMPLATES 数组来添加自定义模板。模板结构如下：

interface MarkdownTemplate {
  name: string;
  description: string;
  format: {
    header?: string;
    chapter_format?: string;
    caption_block: string;
    timestamp_format?: string;
    search_result_format?: string;
  }
}

许可证

MIT

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 将更改推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request