MCP YouTube Server

MCP YouTube Server

site icon
2025.04.18 0
PythonYouTube 交互视频搜索视频详情获取娱乐功能
MCP YouTube Server 是一个基于 Model Context Protocol (MCP) 的服务器,提供与 YouTube 交互的工具。它允许 MCP 主机应用程序(如 Claude for Desktop)搜索 YouTube 视频并获取特定视频的详细信息。
View on GitHub

Overview

基本能力

产品定位

MCP YouTube Server 是一个专门用于与 YouTube 平台交互的工具服务器,旨在通过 MCP 协议为应用程序提供 YouTube 数据访问能力。

核心功能

  • 搜索 YouTube 视频
  • 获取特定视频的详细信息
  • 获取频道详情
  • 列出频道视频
  • 搜索播放列表
  • 获取播放列表内容
  • 获取相关视频
  • 获取热门视频

适用场景

  • 在应用程序中集成 YouTube 视频搜索功能
  • 获取 YouTube 视频的详细信息用于展示或分析
  • 管理 YouTube 频道内容
  • 发现相关或热门视频

工具列表

  • search_videos: 根据查询字符串搜索 YouTube 视频
  • get_video_details: 获取特定视频的详细信息
  • get_channel_details: 获取特定频道的详细信息
  • list_channel_videos: 列出特定频道上传的视频
  • search_playlists: 搜索 YouTube 播放列表
  • get_playlist_items: 获取播放列表中的视频
  • get_related_videos: 查找与给定视频相关的视频
  • get_popular_videos: 列出特定地区或类别中最受欢迎的视频

常见问题解答

  • 需要 YouTube Data API v3 Key 才能使用
  • Windows 用户可能需要手动设置,因为脚本是为 bash 环境设计的

使用教程

使用依赖

  • Python 3.10 或更高版本
  • uv(必须在运行设置前安装)
  • YouTube Data API v3 Key
  • bash 兼容的 shell(主要用于 Linux/macOS)

安装 uv 的命令:

pip install uv

安装教程

  1. 克隆仓库:
git clone https://github.com/davo00019/mcp-server-youtube.git
cd mcp-server-youtube
  1. 运行设置脚本:
bash setup.sh
  1. 配置 MCP 主机:
  2. 按照 setup.sh 脚本打印的说明操作
  3. 将提供的 'Wrapper Script Path' 复制到 MCP 主机的配置文件中

调试方式

  • 确保 .env 文件中有正确的 YouTube API Key
  • 检查 MCP 主机配置是否正确
  • 重启 MCP 主机应用程序

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。