Py MCP Youtube Toolbox

py-mcp youtube工具箱

!

MCP服务器为AI助手提供了与YouTube交互的强大工具，包括视频搜索、转录提取、评论检索等。

概述

py-mcp youtube工具箱提供以下与youtube相关的功能：

• 使用高级过滤选项搜索YouTube视频
• 获取有关视频和频道的详细信息
• 使用排序选项检索视频评论
• 提取多种语言的视频转录和字幕
• 查找给定视频的相关视频
• 按地区获取热门视频
• 根据成绩单生成视频内容摘要
• 具有过滤、搜索和多视频功能的高级转录分析

目录

• 先决条件
• 安装
• 配置MCP设置
• 工具文档

- 视频工具 - 渠道工具 - 成绩单工具 - 提示工具 - 资源工具

• 发展
• 许可证

先决条件

1. python：安装Python 3.12或更高版本
2. YouTube API密钥:

- 首选 谷歌云控制台 - 创建新项目或选择现有项目 - 启用YouTube数据API v3: 1. 转到“API和服务”>“库” 1. 搜索并启用“YouTube数据API v3” - 创建凭据： 1. 转到“API和服务”>“凭据” 1. 单击“创建凭据”>“API密钥” 1. 记下API键

安装

克隆

git clone https://github.com/jikime/py-mcp-youtube-toolbox.git
cd py-mcp-youtube-toolbox

配置

1. 安装UV包管理器：

curl -LsSf https://astral.sh/uv/install.sh | sh

1. 创建并激活虚拟环境：

uv venv -p 3.12
source .venv/bin/activate  # On MacOS/Linux
# or
.venv\Scripts\activate  # On Windows

1. 安装依赖项：

uv pip install -r requirements.txt

1. 环境变量：

cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_key

使用Docker

1. 构建Docker镜像：

docker build -t py-mcp-youtube-toolbox .

1. 运行容器：

docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolbox

使用本地

1. 运行服务器：

mcp run server.py

1. 运行MCP检查器：

mcp dev server.py

配置MCP设置

将服务器配置添加到MCP设置文件中：

Claude桌面应用程序

1. 通过自动安装 史密瑟里:

npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claude

1. 手动安装

打开 ~/Library/Application Support/Claude/claude_desktop_config.json

将此添加到 mcpServers 对象：

{
  "mcpServers": {
    "YouTube Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-youtube-toolbox",
        "run",
        "server.py"
      ],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key"
      }
    }
  }
}

光标IDE

打开 ~/.cursor/mcp.json

将此添加到 mcpServers 对象：

{
  "mcpServers": {
    "YouTube Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-youtube-toolbox",
        "run",
        "server.py"
      ],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "YouTube Toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "YOUTUBE_API_KEY=your_youtube_api_key",
        "py-mcp-youtube-toolbox"
      ]
    }
  }
}

工具文档

视频工具

• search_videos：使用高级过滤选项（频道、持续时间、地区等）搜索YouTube视频
• get_video_details：获取特定YouTube视频的详细信息（标题、频道、观看次数、点赞等）
• get_video_comments：使用排序选项从YouTube视频中检索评论
• get_related_videos：查找与特定YouTube视频相关的视频
• get_trending_videos：按地区在YouTube上获取热门视频

渠道工具

• get_channel_details：获取有关YouTube频道的详细信息（名称、订阅者、浏览量等）

成绩单工具

• get_video_transcript：从YouTube视频中提取指定语言的文字记录/字幕
• get_video_enhanced_transcript：具有过滤、搜索和多视频功能的高级转录提取

提示工具

• transcript_summary：根据带有可定制选项的成绩单生成YouTube视频内容摘要

资源工具

• youtube://available-youtube-tools：获取所有可用YouTube工具的列表
• youtube://video/{video_id}：获取特定视频的详细信息
• youtube://channel/{channel_id}：获取特定频道的信息
• youtube://transcript/{video_id}?language={language}：获取特定视频的文字记录

发展

对于本地测试，您可以使用附带的客户端脚本：

# Example: Search videos
uv run client.py search_videos query="MCP" max_results=5

# Example: Get video details
uv run client.py get_video_details video_id=zRgAEIoZEVQ

# Example: Get channel details
uv run client.py get_channel_details channel_id=UCRpOIr-NJpK9S483ge20Pgw

# Example: Get video comments
uv run client.py get_video_comments video_id=zRgAEIoZEVQ max_results=10 order=time

# Example: Get video transcript
uv run client.py get_video_transcript video_id=zRgAEIoZEVQ language=ko

# Example: Get related videos
uv run client.py get_related_videos video_id=zRgAEIoZEVQ max_results=5

# Example: Get trending videos
uv run client.py get_trending_videos region_code=ko max_results=10

# Example: Advanced transcript extraction
uv run client.py get_video_enhanced_transcript video_ids=zRgAEIoZEVQ language=ko format=timestamped include_metadata=true start_time=100 end_time=200 query=에이전트 case_sensitive=true segment_method=equal segment_count=2

# Example: 

许可证

MIT许可证