article
README
🚀 YouTube 数据 MCP 服务器
这是一个用于提取 YouTube 视频文字稿和评论的 Model Context Protocol (MCP) 服务器。它提供了一系列工具,可获取 YouTube 视频的文字稿和评论,为后续的分析和总结工作提供支持。
✨ 主要特性
getTranscript:从 YouTube 视频中提取字幕/文字稿。getVideoInfo:获取 YouTube 视频的基本信息。getReplies:检索 YouTube 视频的评论(使用 SerpAPI)。getCommentReplies:获取特定 YouTube 评论的回复。
📦 安装指南
开发者安装步骤
# 克隆仓库
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 结合使用:
- 将服务器添加到您的 Claude 配置文件中:
{
"mcpServers": {
"youtube-data": {
"command": "npx",
"args": ["-y","youtube-data-mcp"],
"env": {
"SERPAPI_KEY": "your_serpapi_key_here"
}
}
}
}
- 重启 Claude 以应用配置。
- 现在您可以使用以下功能:
getTranscript:从 YouTube 视频中提取文字稿。getVideoInfo:获取视频信息。getReplies:获取评论。getCommentReplies:获取回复。
📚 详细文档
API 工具
-
youtube_search(query):根据关键词搜索 YouTube 视频。
- 参数:
query:要搜索的关键词或短语。
- 返回:
- 搜索结果列表,包含视频 ID 和标题。
- 参数:
-
get_transcript(video_id):从指定的 YouTube 视频中提取文字稿。
- 参数:
video_id:YouTube 视频的唯一标识符。
- 返回:
- 字幕内容和元数据。
- 参数:
-
get_video_info(video_id):获取 YouTube 视频的详细信息。
- 参数:
video_id:YouTube 视频的唯一标识符。
- 返回:
- 视频标题、描述、发布者信息和统计信息(观看次数、点赞数等)。
- 参数:
-
get_comments(video_id, page_token):获取 YouTube 视频的评论,支持分页。
- 参数:
video_id:YouTube 视频的唯一标识符。page_token:分页标记,用于获取更多评论(可选,默认为 null)。
- 返回:
- 当前页面的评论列表和新的分页标记。
- 参数:
-
get_comment_replies(comment_id, page_token):获取特定评论的所有回复,支持分页。
- 参数:
comment_id:特定评论的唯一标识符。page_token:分页标记,用于获取更多回复(可选,默认为 null)。
- 返回:
- 当前页面的回复列表和新的分页标记。
- 参数:
🔧 技术细节
需求
- Node.js 16+
- TypeScript
- SerpAPI API 密钥(用于评论功能)
故障排除
- 如果遇到 400 错误,请检查您的 SerpAPI 密钥是否有效且正确设置在 .env 文件中。
- 查看服务器日志以获取详细错误信息和调试数据。
- 对于评论相关问题,请确保 SerpAPI 支持当前使用的 YouTube Video API 格式。
📄 许可证
MIT
微信扫一扫