Fast Video Cataloger

Fast Video Cataloger MCP 服务

通过 AI 助手搜索、查看和标记本地视频库。

Fast Video Cataloger 可在 Windows 上为你自己的视频文件建立可搜索的目录：场景缩略图、关键词、 转录文本和人脸。此 MCP 服务让 Claude 等助手能够使用该目录。 你用自己的话描述需要的素材；助手会搜索、查看实际镜头，并为你整理归档。

• 根据说过的内容查找视频和片段，并显示时间码
• 通过描述画面查找场景（“夜晚城市上空的无人机镜头”），无需预先添加标签
• 获取场景缩略图，让助手查看并判断镜头
• 使用 Editor 密钥：添加或移除关键词、创建素材箱、为新视频建立索引

它连接到你自己电脑上的 Fast Video Cataloger 服务。视频不会上传；助手只会收到它所请求的标题、转录文本行和场景图像。

了解更多：视频库的 MCP 服务

要求

• Windows 10 或 11（x64）
• Fast Video Cataloger 10.4 或更高版本。免费 30 天试用版也可以使用。fvc-mcp.exe 也会随程序一起安装， 并包含其所需的 .NET 10 运行时。
• 通过 Fast Video Cataloger 服务共享你的目录：在程序中打开起始页的 Server 部分，然后点击 Setup。助手连接到服务，而非 桌面程序，因此即使程序关闭也能使用。
• API 密钥：在同一 Server 部分中打开 Manage Users。使用 Viewer 可搜索和读取，使用 Editor 还可添加标签和创建素材箱。

安装

Claude Desktop：一键安装

从 Releases 下载 fvc-mcp-<version>.mcpb 并打开。 Claude Desktop 会询问服务地址（如果服务运行在这台电脑上，请保留 http://localhost:8754）和 API 密钥。

Claude Desktop：配置文件

使用随 Fast Video Cataloger 安装的副本。在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "fast-video-cataloger": {
      "command": "C:\\Program Files\\FastVideoCataloger\\fvc-mcp.exe",
      "env": {
        "FVC_SERVER_URL": "http://localhost:8754",
        "FVC_API_KEY": "fvc_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add fast-video-cataloger --env FVC_SERVER_URL=http://localhost:8754 --env FVC_API_KEY=fvc_your_key_here "--" "C:\Program Files\FastVideoCataloger\fvc-mcp.exe"

在 PowerShell 中保留 "--" 两侧的引号。

Gemini CLI

gemini mcp add fast-video-cataloger "C:\Program Files\FastVideoCataloger\fvc-mcp.exe" -s user -e FVC_SERVER_URL=http://localhost:8754 -e FVC_API_KEY=fvc_your_key_here

完整设置说明、试用建议和故障排除： 连接 AI 助手（MCP）。

配置

变量	含义
FVC_SERVER_URL	目录服务的地址。默认为 http://localhost:8754。
FVC_API_KEY	API 密钥。
FVC_MCP_LOG_LEVEL	默认为 Warning；连接无法建立时可设为 Information 或 Debug。日志输出到 stderr。

工具（23）

工具	功能
search_videos	通过自由文本或关键词查找视频。
search_scenes	查找单个场景及其时间码。
search_scenes_semantic	通过描述画面，或查找与指定场景相似的场景。需要视觉搜索索引；对于描述搜索，还需要服务器上的 Visual search 模型。
search_transcripts	查找口语内容及其所属视频和时间码。
search_actors	按姓名或标签查找人物。
list_keywords	列出目录中的所有关键词，以便助手了解可搜索的内容。
get_video	获取一条完整的目录条目。
get_video_scenes	按时间码顺序获取视频的场景缩略图。
get_video_transcript	获取带时间戳的逐行转录文本。
get_video_tags、get_video_actors	获取关键词和演员表。
get_scene_image	获取缩略图本身，以便助手查看画面。
catalog_stats、list_bins、get_bin_videos	获取目录大小、为其提供服务的构建版本，以及现有的集合。
tag_video、tag_scene	为视频或单个场景添加关键词。需要编辑器密钥。
untag_video、untag_scene	移除指定的关键词。需要编辑器密钥。
create_bin、add_video_to_bin	创建集合。需要编辑器密钥。
index_video、list_videos_needing_indexing	为尚无缩略图的目录条目建立索引。需要编辑器密钥。

它无法删除视频或集合、将视频从集合中移除、播放视频或操作播放器。

源代码

src/FvcMcpServer 是随 Fast Video Cataloger 一同发布的 fvc-mcp.exe 的源代码，每次发布时都会复制此源代码。它是 Fast Video Cataloger 服务器 REST API 的轻量客户端：不保存任何状态，每个工具只发出一到两个 REST 调用。使用 .NET 10 SDK 构建：

dotnet publish src/FvcMcpServer -c Release -r win-x64 --self-contained false -p:PublishSingleFile=true

已发布的构建版本由 VideoStorm Sweden AB 进行代码签名。欢迎提交问题和拉取请求；此处的代码会与 Fast Video Cataloger 中的版本保持一致，因此被接受的更改将在下一次发布时推出。

许可证

此仓库中的源代码采用 MIT 许可证，详见 LICENSE。捆绑的软件包详见 THIRD-PARTY-NOTICES.md。Fast Video Cataloger 本身是商业软件，提供 30 天免费试用。