YouTube 数据 MCP 服务器

一个用于提取 YouTube 视频字幕和评论的模型上下文协议 (MCP) 服务器。此服务器提供从 YouTube 视频获取字幕和评论以进行分析和总结的工具。

功能

• getTranscript: 从 YouTube 视频中提取字幕/文本
• getVideoInfo: 获取 YouTube 视频的基本信息
• getReplies: 获取 YouTube 视频的评论（使用 SerpAPI）
• getCommentReplies: 获取特定 YouTube 评论的回复

要求

• Node.js 16+
• TypeScript
• SerpAPI API 密钥（用于评论功能）

安装（开发者）

# 克隆仓库
git clone https://github.com/diasm3/serpapi-youtube-mcp-server.git
cd youtube-data-mcp

# 安装依赖
npm install

配置

在根目录中创建一个 .env 文件，其中包含您的 SerpAPI 密钥：

SERPAPI_KEY=your_serpapi_key_here

您可以通过在 SerpAPI 上注册来获取 SerpAPI 密钥。

构建和运行

# 构建项目
npm run build

# 运行服务器
npm start

服务器将开始运行并通过 stdin/stdout 监听命令。

与 Claude 一起使用

要将此 MCP 服务器与 Claude 一起使用：

1. 将服务器添加到您的 Claude 配置文件：

{
  "mcpServers": {
    "youtube-data": {
      "command": "npx",
      "args": ["-y","youtube-data-mcp"],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key_here"
      }
    }
  }
}

2. 重新启动 Claude 以应用配置。

3. 现在您可以要求 Claude 执行以下操作：

   • "获取此 YouTube 视频的字幕：[URL]"
   • "显示此 YouTube 视频的评论：[URL]"
   • "获取特定评论的回复"

API 工具

searchYoutube

在 YouTube 上搜索视频、频道和播放列表。

参数：

• query: YouTube 的搜索查询（必需）
• limit: 要返回的最大结果数（可选，默认值：10）
• gl: 搜索结果的国家/地区代码（可选，例如，“us”、“kr”、“jp”）
• hl: 搜索结果的语言代码（可选，例如，“en”、“ko”、“ja”）
• sp: 用于过滤或分页的特殊参数（可选）
• pageToken: 来自先前响应的分页令牌（可选）

示例（通过 Claude）：

在 YouTube 上搜索“JavaScript 教程”，并显示前 5 个结果

getVideoInfo

检索有关 YouTube 视频的基本信息。

参数：

• url: YouTube 视频 URL 或视频 ID（必需）

返回：

• videoId: 视频的 ID
• title: 视频的标题
• viewCount: 观看次数
• publishDate: 视频的发布日期
• channelName: 发布视频的频道名称
• commentCount: 视频上的评论数
• commentsNextPageToken: 用于获取评论的令牌
• commentsSortingTokens: 用于不同评论排序选项的令牌

示例（通过 Claude）：

获取有关此 YouTube 视频的信息：https://www.youtube.com/watch?v=dQw4w9WgXcQ

getTranscript

从 YouTube 视频中提取字幕/文本。

参数：

• url: YouTube 视频 URL 或视频 ID（必需）
• lang: 字幕的语言代码（可选，默认值：“en”）

示例（通过 Claude）：

请获取此 YouTube 视频的字幕：https://www.youtube.com/watch?v=dQw4w9WgXcQ

getReplies

使用 SerpAPI 从 YouTube 视频中检索评论。

参数：

• url: YouTube 视频 URL 或视频 ID（初始页面必需，分页可选）
• limit: 要检索的最大评论数（可选，默认值：100）
• sort: 评论的排序顺序（“relevance”或“time”，可选，默认值：“relevance”）
• pageToken: 来自先前响应的分页令牌（可选）

示例（通过 Claude）：

显示此 YouTube 视频的评论：https://www.youtube.com/watch?v=dQw4w9WgXcQ

getCommentReplies

获取特定 YouTube 评论的回复。

参数：

• pageToken: 从评论中获取其回复的回复令牌（必需）

此函数通常在从评论中获取 repliesToken 后以编程方式使用。

了解 SerpAPI 集成

此 MCP 服务器使用 SerpAPI 的 YouTube 搜索 API 和 YouTube 视频 API 来获取搜索结果、评论和其他数据。 SerpAPI 提供了一种无需直接使用 YouTube 官方 API 即可抓取 YouTube 数据的方法。

关于 SerpAPI 使用的关键点：

• 服务器使用带有 v 参数（YouTube 视频 ID）的 youtube_video 引擎
• 评论使用 API 响应中返回的令牌进行分页
• 评论回复使用其特定令牌单独获取
• API 调用受您的 SerpAPI 订阅计划限制

故障排除

• 如果遇到 400 Bad Request 错误，请验证您的 SerpAPI 密钥是否有效并且已在 .env 文件中正确设置
• 检查服务器日志以获取详细的错误消息和调试信息
• 对于与评论相关的问题，请确保 SerpAPI 仍然支持使用的 YouTube 视频 API 格式

许可证

MIT