YouTube Data MCP Server

YouTube Data MCP 服务

用于提取 YouTube 视频字幕、评论和搜索结果的模型上下文协议（MCP）服务。支持 Stdio 和 StreamableHTTP 两种传输方式。

功能

• getTranscript - 提取字幕，可选择包含时间戳
• getVideoInfo - 获取视频元数据（标题、观看次数、评论数）
• getComments - 获取评论，支持分页和排序
• getCommentReplies - 获取特定评论的回复
• searchYoutube - 搜索视频、频道和播放列表

v2.0 新增内容

• 双传输方式：Stdio（默认）+ StreamableHTTP，支持 Web 集成
• 可靠的字幕提取：将 youtube-transcript 替换为 youtube-caption-extractor（绕过机器人检测，支持无服务器环境）
• 时间戳支持：可选包含每个字幕片段的开始时间和时长
• 模块化架构：清晰分离各项职责（配置、类型、服务、工具）
• MCP SDK v1.25.2：最新 SDK，稳定性有所提升

要求

• Node.js 18+
• SerpAPI 密钥（用于搜索、评论和视频信息）

安装

git clone https://github.com/diasm3/serpapi-youtube-mcp-server.git
cd serpapi-youtube-mcp-server
npm install

配置

创建 .env 文件：

SERPAPI_KEY=your_serpapi_key_here
PORT=3000  # optional, for HTTP mode

前往 serpapi.com 获取 SerpAPI 密钥。

运行服务

# Build
npm run build

# Stdio mode (default) - for Claude Desktop, Cursor, etc.
npm start

# HTTP mode - for web applications
npm start -- --http
# or
MCP_TRANSPORT=http npm start

HTTP 端点

以 HTTP 模式运行时：

• GET /health - 健康检查
• POST /mcp - MCP 请求处理程序

MCP 客户端配置

Claude Desktop / Cursor

{
  "mcpServers": {
    "youtube-data": {
      "command": "node",
      "args": ["/path/to/serpapi-youtube-mcp-server/build/index.js"],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key_here"
      }
    }
  }
}

使用 npx

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

API 工具

getTranscript

从 YouTube 视频中提取字幕。

参数	类型	必填	说明
url	string	是	YouTube URL 或视频 ID
lang	string	否	语言代码（默认：'en'）
includeTimestamps	boolean	否	包含每个片段的开始时间和时长

Get the Korean transcript for https://youtube.com/watch?v=xxxxx with timestamps

getVideoInfo

使用 SerpAPI 获取视频元数据。

参数	类型	必填	说明
url	string	是	YouTube URL 或视频 ID

返回：标题、观看次数、发布日期、频道、评论数、分页令牌

getComments

获取视频评论，支持分页。

参数	类型	必填	说明
url	string	有条件	获取第一页时必填
limit	number	否	评论数上限（默认：100）
sort	string	否	'relevance' 或 'time'
pageToken	string	否	用于分页

getCommentReplies

获取特定评论的回复。

参数	类型	必填	说明
pageToken	string	是	评论中的 repliesToken

searchYoutube

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

参数	类型	必填	说明
query	string	是	搜索查询
limit	number	否	结果数上限（默认：10）
gl	string	否	国家代码（us、kr、jp）
hl	string	否	语言代码（en、ko、ja）
sp	string	否	过滤参数
pageToken	string	否	用于分页

项目结构

src/
├── index.ts          # Server entry (Stdio + HTTP)
├── config/           # Environment configuration
├── types/            # Zod schemas + TypeScript types
├── services/
│   ├── serpapi.ts    # SerpAPI integration
│   └── youtube.ts    # Transcript extraction
├── tools/            # MCP tool definitions
└── utils/            # Helper functions

故障排除

字幕不可用

• 某些视频未启用字幕
• 尝试使用其他语言代码（en、ko、ja 等）
• 并非所有视频都提供自动生成的字幕

SerpAPI 错误

• 确认 API 密钥有效
• 检查 SerpAPI 配额和限制
• 确认视频可公开访问

HTTP 模式无法启动

• 检查 PORT 是否已被占用
• 确认已设置环境变量

许可证

MIT