视频智能分析工具

MCP视频智能分析服务器,用于AI驱动的视频分析,支持从任何视频URL提取关键帧、转录文本和视觉内容,适用于Claude Code或任何MCP客户端。

  • by ipythonist
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 ipythonist/mcp-video

使用说明

mcp视频

用于人工智能视频分析的视频智能MCP服务器。从任何视频URL中提取关键帧、转录本和视觉内容——就在Claude Code或任何MCP客户端中。

它做什么

将其指向任何视频(YouTube、Vimeo、Twitter/X、Instagram和 1000+个网站)并得到:

  • 关键帧提取 --场景变化检测选取最有意义的帧
  • 转录提取 --带有时间戳的自动字幕或手动字幕
  • 全面分析 --帧+转录在一起,实现全面的视频理解
  • 时间戳快照 --在任何特定时刻抓住一个框架
  • 视频到战略 --从YouTube/Instagram教程中提取交易策略,并生成可运行的Python代码(backtrader、zipline、panda-ta、freqtrade)

与克劳德的视觉能力一起工作,以理解视频中实际显示的内容,而不仅仅是所说的内容。

交易策略提取

将其指向任何交易教程视频,并获得完整、可运行的策略:

Convert this trading strategy to code: https://youtube.com/watch?v=...

Extract the RSI strategy from this video and generate backtrader code: https://youtube.com/watch?v=...

它从视频帧和转录中提取图表模式、指标、进入/退出规则,然后为您的首选框架生成代码。

安装

# Requires Python 3.10+ and ffmpeg
pip install mcp-video

# Or with uv
uv pip install mcp-video

系统相关性

# macOS
brew install ffmpeg yt-dlp

# Ubuntu/Debian
sudo apt install ffmpeg
pip install yt-dlp

# Windows
choco install ffmpeg yt-dlp

使用Claude代码

添加到您的Claude Code MCP配置中(~/.claude/claude_code_config.json):

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

然后在Claude Code中,只需问:

Analyze this video: https://youtube.com/watch?v=...

What code is shown in this tutorial? https://youtube.com/watch?v=...

Summarize the key points from this talk: https://youtube.com/watch?v=...

与任何MCP客户端一起使用

# Run as stdio server (default)
mcp-video

# Run as HTTP server
python -m mcp_video.server --transport streamable-http

工具

analyze_video

全视频分析——提取关键帧和转录,返回图像+文本。

参数 类型 默认值 说明
url string 必填 视频URL
max_frames int 8 要提取的最大关键帧数
include_transcript bool true 包含标题

extract_video_frames

仅提取帧,使用关键帧检测或均匀间距。

参数 类型 默认值 说明
url string 必填 视频URL
max_frames int 10 帧数
mode string “关键帧” “关键框”或“统一”

get_video_transcript

获取带时间戳的成绩单/字幕。

参数 类型 默认值 说明
url string 必填 视频URL

get_frame_at_time

在特定时间戳提取单个帧。

参数 类型 默认值 说明
url string 必填 视频URL
timestamp float 必填 时间(秒)

video_to_strategy

从教程视频中提取交易策略并生成可运行的代码。

参数 类型 默认值 说明
url string 必填 带有交易策略的视频URL
framework string “backtrader” 目标:backtrader、zipline、pandas ta、freqtrade
max_frames int 15 更多帧=捕获更多图表细节

运作原理

  1. 下载 --用途 yt-dlp 下载视频(限制为720p以节省带宽)
  2. 关键帧检测 --OpenCV直方图比较检测场景变化
  3. 帧编码 --调整为512px宽度的帧,编码为JPEG base64
  4. 转录本 --提取YouTube自动字幕或手动字幕
  5. MCP响应 --退货 ImageContent + TextContent 供法学硕士分析

所有处理都在本地进行。没有数据发送到第三方服务。

发展

git clone https://github.com/ipythonist/mcp-video.git
cd mcp-video
uv venv && uv pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/

许可证

麻省理工学院