Repository avatar
Search & Data Extraction
v10.6.0
active

fvc-mcp

com.videocataloger/fvc-mcp

Search, view and tag your local video library from Claude: transcripts, scenes, visual search.

Documentation

Fast Video Cataloger MCP server

Search, view and tag your local video library from an AI assistant.

Fast Video Cataloger keeps a searchable catalog of your own video files on Windows: scene thumbnails, keywords, transcripts and faces. This MCP server lets an assistant such as Claude work with that catalog. You ask for footage in your own words; the assistant searches, looks at the actual shots and does the filing for you.

  • Find videos and moments by what was said, with timecodes
  • Find scenes by describing the picture ("a drone shot over a city at night"), nothing tagged first
  • Fetch scene thumbnails so the assistant can see and judge a shot
  • With an Editor key: add or remove keywords, build bins, edit video details and cast, manage keywords, keyword groups and people, index new videos

It runs against the Fast Video Cataloger server on your own computer. No video is uploaded; the assistant receives the titles, transcript lines and scene images it asks for.

More: MCP server for your video library

Requirements

  • Windows 10 or 11 (x64)
  • Fast Video Cataloger 10.4 or later; the tools added since then need the server version that added them (10.5: video details, cast, taking a video out of a bin; 10.6: keyword management, keyword groups, people, video file path). The free 30-day trial works. fvc-mcp.exe is also installed with the program, together with the .NET 10 runtime it needs.
  • Your catalog shared through the Fast Video Cataloger server: in the program, open the start page's Server section and click Setup. The assistant connects to the server, not to the desktop program, so it works with the program closed.
  • An API key: Manage Users in the same Server section. Viewer to search and read, Editor to also tag, build bins and edit the catalog.

Install

Claude Desktop: one click

Download fvc-mcp-<version>.mcpb from Releases and open it. Claude Desktop asks for the server address (leave http://localhost:8754 when the server runs on this computer) and your API key.

Claude Desktop: config file

Use the copy installed with Fast Video Cataloger. In 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"

Keep the quotes around "--" in 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

Full setup, things to try and troubleshooting: Connect an AI Assistant (MCP).

Configuration

VariableMeaning
FVC_SERVER_URLAddress of your catalog server. Default http://localhost:8754.
FVC_API_KEYThe API key.
FVC_MCP_LOG_LEVELWarning by default; Information or Debug when a connection will not come up. Logs go to stderr.

Tools (40)

ToolWhat it does
search_videosFind videos by free text or by keyword.
search_scenesFind individual scenes, with their timecodes.
search_scenes_semanticFind scenes by describing the picture, or scenes that look like a given one. Needs the visual search index and, for descriptions, the Visual search model on the server.
search_transcriptsFind spoken words, with their video and timecode.
search_actorsFind people by name or tag.
list_keywordsEvery keyword in the catalog, so the assistant knows what it can search for.
get_videoOne catalog entry in full.
get_video_scenesA video's scene thumbnails in timecode order.
get_video_transcriptThe transcript as timed lines.
get_video_tags, get_video_actorsKeywords and cast.
get_scene_imageThe thumbnail image itself, so the assistant can see the shot.
catalog_stats, list_bins, get_bin_videosCatalog size, the build serving it, and existing bins.
tag_video, tag_sceneAdd keywords to a video or a single scene. Editor key.
untag_video, untag_sceneRemove named keywords again. Editor key.
create_bin, add_video_to_bin, remove_video_from_binBuild a collection, or take a video out of one. Editor key.
update_videoChange a video's title, description, link or rating. Editor key.
add_actor_to_video, remove_actor_from_videoPut a person in a video's cast, or take them out. Editor key.
create_actor, update_actor, delete_actorAdd a person to the catalog, change their name, bio or link, or delete them. Editor key.
keyword_usageHow many videos and scenes carry a keyword.
rename_keyword, delete_keywordRename or delete a keyword everywhere it is used. Cannot be undone. Editor key.
list_keyword_groupsThe keyword groups, such as Places or Clients, with their keywords.
create_keyword_group, rename_keyword_group, delete_keyword_group, add_keyword_to_group, remove_keyword_from_groupSort keywords into groups. Editor key.
set_video_pathPoint a catalog entry at a video file that was moved or renamed. Editor key.
index_video, list_videos_needing_indexingIndex catalog entries that have no thumbnails yet. Editor key.

It cannot delete videos or bins, play video or drive the player.

Source

src/FvcMcpServer is the source of the fvc-mcp.exe shipped with Fast Video Cataloger, copied from each release. It is a thin client over the Fast Video Cataloger server's REST API: it holds no state and every tool is one or two REST calls. Build with the .NET 10 SDK:

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

Released builds are code-signed by VideoStorm Sweden AB. Issues and pull requests are welcome; the code here follows the version in Fast Video Cataloger, so accepted changes ship with the next release.

License

MIT for the source in this repository, see LICENSE. Bundled packages: THIRD-PARTY-NOTICES.md. Fast Video Cataloger itself is commercial software with a free 30-day trial.

MCPB
https://github.com/frelo/fvc-mcp/releases/download/v10.6.0/fvc-mcp-10.6.0.mcpb
Install Command
# mcpb: https://github.com/frelo/fvc-mcp/releases/download/v10.6.0/fvc-mcp-10.6.0.mcpb