vidscribe (Devsternrassler)

摄录员

视频转录通过 yt-dlp + 耳语翻译2 （更快的耳语引擎）——作为Claude的CLI或MCP服务器。

灵感

该项目基于以下理念 nhatvu148/视频转录器mcp --一个结合yt-dlp和OpenAI Whisper进行视频转录的TypeScript MCP服务器。我们采用了这个概念，并在Go中重新构建了它，但有一些关键的区别：

• 零依赖安装 通过 uvx --无需手动yt-dlp、耳语或Python设置
• 更快的耳语 （CTranslate2）而不是openai耳语——速度更快，内存使用率更低
• 单静态二进制 --无需Node.js/npm运行时
• CLI+MCP合二为一 --既可用作独立命令，也可用作MCP服务器

需求

• 紫外线 （提供 uvx --无需单独安装yt-dlp或耳语）
• ffmpeg

用法

# Transcribe a YouTube video
vidscribe "https://youtube.com/watch?v=XYZ"

# With browser cookie auth (for age-restricted / private videos)
vidscribe "https://youtube.com/watch?v=XYZ" --cookies-browser chrome

# Larger model, German language, all output formats
vidscribe "https://youtube.com/watch?v=XYZ" \
  --model medium \
  --language de \
  --format txt,md,json,srt,vtt

# GPU acceleration (float16 is selected automatically when device is auto or cuda)
vidscribe "https://youtube.com/watch?v=XYZ" --model large --device cuda

# Check dependencies
vidscribe --mcp  # then call check_dependencies via MCP

MCP服务器（克劳德集成）

添加 ~/.claude.json:

{
  "mcpServers": {
    "vidscribe": {
      "command": "vidscribe",
      "args": ["--mcp"]
    }
  }
}

可用的MCP工具：

transcribe_video 参数：

平台支持

YouTube兼容性

yt-dlp≥2025需要一个JavaScript运行时来提取YouTube。vidscribe自动检测 node 从PATH中自动传递。如果提取失败，请安装Node.js或deno，并确保它在PATH中。在Linux上， secretstorage 通过以下方式自动注射 uvx --with secretstorage 无需手动安装Python包即可启用浏览器cookie解密。

旗帜

测试

使用Go构建标签将测试分为三层：

# Unit tests — pure logic, no external deps, <1s
make test

# Smoke tests — requires uvx + ffmpeg in PATH
make test-smoke

# E2E tests — requires uvx + ffmpeg + network, full transcription
make test-e2e

# Performance benchmarks (CPU vs CUDA vs openai-whisper)
make test-bench

覆盖测试视频（默认：“我在动物园”，19秒）：

VIDSCRIBE_TEST_URL="https://youtube.com/watch?v=..." make test-e2e
VIDSCRIBE_TEST_BROWSER=firefox make test-e2e