MCP ytb server

mcp_ytb_server（视频管道mcp）

一个基于Go的MCP（stdio）服务器，提供视频处理管道：下载（yt-dlp）、修剪/合并/编码（ffmpeg）、字幕（yt-dlp/耳语）、效果和导出。

代表：https://github.com/j4flmao/mcp_ytb_server

需求

• yt-dlp （必填）
• ffmpeg + ffprobe （必填）
• whisper / whisper.cpp （可选；仅在使用Whisper字幕生成工具时需要）

安装

选项1：通过运行 npx （推荐；无需Go）

此仓库在\[npm/\]中包含一个npm包装器(file:///d:/mcp_ytb_server/npm)所以终端用户只需要Node.js+ npx.

Claude桌面配置（Windows示例）：

• 配置文件路径： %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-ytb-server": {
      "command": "npx",
      "args": ["-y", "@mcp_ytb/mcp_ytb_server"]
    }
  }
}

可选配置（手动）：

• 在Claude Desktop中，您可以添加 env 物体下 mcp-ytb-server 设置默认值（例如输出目录、默认质量、Cookie）。
• 在提示中，您还可以覆盖每次调用（例如“保存到D:\\视频”或“使用Cookie文件…”）。

对于 npx 发布，将二进制文件放置在：

• npm/bin/windows-amd64/video-mcp.exe
• npm/bin/linux-amd64/video-mcp
• npm/bin/darwin-amd64/video-mcp
• npm/bin/darwin-arm64/video-mcp

选项2：使用预构建的二进制文件（高级）

• 从GitHub Release下载适用于您操作系统的正确二进制文件，并将其放置在稳定的路径中。

选项3：从源代码构建（高级；需要Go）

cd D:\mcp_ytb_server
go test ./...
go build -o .\video-mcp.exe .

Claude桌面配置

配置文件（Windows）：

• %APPDATA%\\Claude\\claude_desktop_config.json

示例配置使用 .exe 二进制（可选）：

{
  "mcpServers": {
    "mcp-ytb-server": {
      "command": "D:\\\\mcp_ytb_server\\\\video-mcp.exe",
      "args": []
    }
  }
}

更新配置后重新启动Claude Desktop（完全退出并重新打开）。

环境变量

• VIDEO_MCP_OUTPUT_DIR：默认输出目录（可选）
• VIDEO_MCP_TEMP_DIR：temp目录（可选）
• VIDEO_MCP_YTDLP_PATH：路径 yt-dlp （默认值： yt-dlp)
• VIDEO_MCP_FFMPEG_PATH：路径 ffmpeg （默认值： ffmpeg)
• VIDEO_MCP_FFPROBE_PATH：路径 ffprobe （默认值： ffprobe)
• VIDEO_MCP_QUALITY：默认下载质量（默认值： best)
• VIDEO_MCP_COOKIE_BROWSER：浏览器用于yt-dlp浏览器cookie提取（例如。 chrome, firefox, none)
• VIDEO_MCP_COOKIE_FILE：路径 cookies.txt （网景格式）；优先于浏览器Cookie

Cookie（YouTube登录/年龄门）

有两种选择：

• 集 VIDEO_MCP_COOKIE_FILE 因此，所有请求都使用 cookies.txt 默认情况下（可选）。
• 在提示中，明确指定cookie文件路径；这 download_video 工具支架 cookie_file （可选，每次通话）。

快速样品

参见\PROMPTS.md\用于测试复制/粘贴提示。

主要工具

• download_video：从URL（yt-dlp）下载视频/音频
• get_video_info：从URL获取元数据
• download_subtitles, list_subtitles：通过yt-dlp字幕
• trim_video, cut_and_keep, merge_clips, split_video
• mute_audio, replace_audio, normalize_audio
• add_fade, add_watermark, blur_region, zoom_effect, color_grade
• export_video, generate_thumbnail, get_file_info

快速故障排除

• Windows Media Player无法播放该文件：您可能遇到编解码器问题（AV1/VP9/HEVC）。使用 export_video 以重新编码为MP4 H.264/AAC。
• 登录/年龄门控视频：配置Cookie（请参阅Cookie部分）。
• Claude没有看到更新的工具：完全退出Claude Desktop（系统托盘）并重新打开。