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_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を利用する薄いクライアントです。状態を保持せず、各ツールは1回または2回の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日間の無料トライアルを利用できます。