需部署youtube字幕mcp服务器、配置hermes技能调用、注入youtube api密钥、测试工作流,并设置本地youtube-dl降级方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望 Hermes Agent 能够自动搜索 YouTube 视频并提取其字幕,需通过外部工具桥接 Model Context Protocol(MCP)服务器与 Hermes 的技能调用能力。以下是实现该功能的具体步骤:
一、部署 YouTube 字幕 MCP 服务器
该服务器作为 Hermes Agent 与 YouTube 字幕服务之间的协议层,负责接收请求、拉取字幕、返回结构化文本及元数据。Hermes 通过标准 MCP 工具调用机制与其通信。
1、在 Hermes 运行环境中新开终端,执行以下命令安装 YouTube 字幕 MCP 服务器:
2、运行 npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client hermes 命令。
3、确认安装完成后,服务器将自动注册至 Hermes 的工具列表中,无需手动修改配置文件。
4、验证服务是否就绪:执行 hermes tool list,检查输出中是否包含 get_transcript 工具项。
二、配置 Hermes 内置技能调用字幕工具
需为 Hermes 显式定义一个可复用的技能,使其能根据用户输入的视频 URL 或关键词自动触发字幕提取流程。该技能将组合 YouTube 搜索与字幕获取两个动作。
1、进入 Hermes 技能管理界面,运行 hermes skill_manage create youtube_subtitle_fetcher。
2、在交互式编辑器中粘贴如下 YAML 内容(注意缩进):
3、填写 name: fetch_yt_subtitle,description: "从 YouTube 视频链接或标题提取指定语言字幕"。
4、在 steps 下添加两步:第一步调用 youtube_search(需提前配置 YouTube Data API v3 密钥),第二步调用 get_transcript 并传入 url 与 lang 参数。
三、注入 YouTube Data API v3 凭据
为支持视频搜索功能,Hermes 需访问 YouTube 官方 API。该凭据独立于 MCP 服务器,必须写入 Hermes 的环境变量配置中。
1、前往 https://console.cloud.google.com/apis/library/youtube.googleapis.com 启用 YouTube Data API v3。
2、创建新凭证,选择“API 密钥”,复制生成的密钥字符串。
3、编辑 Hermes 配置文件:vim ~/.hermes/.env。
4、在文件末尾新增一行:YOUTUBE_API_KEY=your_api_key_here,保存退出。
四、测试完整工作流
启动 Hermes 会话后,可通过自然语言指令触发端到端流程。系统将自动完成视频检索、URL 解析、字幕拉取与格式化返回,全程无需人工介入。
1、在终端中执行 hermes chat 进入交互模式。
2、输入指令:请查找标题含“LLM推理优化”的最新YouTube视频,并提取其中文字字幕。
3、观察日志输出:Hermes 先调用 youtube_search 获取首个匹配视频 ID,拼接为完整 URL。
4、随后调用 get_transcript,参数为该 URL 与默认语言 en,最终返回带时间戳的纯文本字幕块。
五、手动补全缺失字幕的备用方案
当目标视频未提供人工字幕或自动生成字幕被禁用时,MCP 服务器将返回空响应。此时需启用本地字幕提取工具链作为降级路径,绕过 YouTube 服务限制。
1、在 Hermes 所在机器上安装 youtube-dl:执行 pip install --upgrade youtube_dl。
2、创建本地脚本 ~/bin/fetch_yt_sub.sh,内容为:youtube-dl --write-sub --skip-download --sub-lang en "$1"。
3、赋予执行权限:chmod +x ~/bin/fetch_yt_sub.sh。
4、在 Hermes 技能 YAML 的 fallback 字段中引用该脚本路径,确保当 MCP 服务器失败时自动切换执行。











