1 v0.1.5 更新于 2026-10-22

videoctx MCP Server

Read videos like images: index once locally, query the text layer, fetch frames on demand.

适用客户端

本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

安装配置

本地运行(pypi)
{
  "mcpServers": {
    "videoctx": {
      "command": "uvx",
      "args": [
        "videoctx"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

提供的工具 接入后 Agent 可调用这 5 个工具

video_overview
返回视频文本层的低成本概览。
survey_video
为每个镜头提供一张缩略图以快速浏览视频。
get_frames
按路径和时间范围获取指定帧图像,可控制细节程度。
transcript_search
在视频转录文本中进行搜索。
index_video
将视频一次性索引为 .vctx 视频上下文。