VidXP MCPサーバー
コミット 2026年11月14日AIクライアントが、音声、音、シーン、アクション、および繰り返し登場する顔に基づいて、検証可能なエビデンスとともに動画をインポート、インデックス、検索できるようにします。
別名 grayhatdevelopers/vidxp
- スター
- 59
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月14日
- ライセンス
- MIT
VidXP MCPとは
VidXPはMCPサーバーです。 AIクライアントが、音声、音、シーン、アクション、および繰り返し登場する顔に基づいて、検証可能なエビデンスとともに動画をインポート、インデックス、検索できるようにします。.
プロジェクトのREADMEから生成された概要
VidXP MCP server について
VidXPは、特定の瞬間を言葉で説明することで、動画ライブラリ内を検索できる機能を開発者やAIエージェントに提供します。このローカルファーストのエンジンにより、ユーザーは動画コレクションをインデックス化し、話された言葉、周囲の音、視覚的なシーン、または複雑なアクションに基づく自然言語クエリを使用してコンテンツを取得できます。Windows、Linux、およびApple Silicon搭載のmacOSで動作するように設計されており、個人用またはプロジェクト用のファイルを自身のマシンに保持する方法を提供します。
開発者は、Pythonパッケージ、HTTP API、またはModel Context Protocolを介して、これらの機能をアプリケーションに統合できます。サーバーは、デスクトップアプリケーション、uvを使用したコマンドラインインターフェース、またはホームサーバー用のDockerコンテナなど、さまざまなデプロイ方法をサポートしています。インデックス作成後、システムは検索結果を検証するためのフレーム、クリップ、またはボードなどの検証可能なエビデンスを提供します。vidxp search speech、vidxp search sound、vidxp search actionなどの特定のツールを使用すると、単なるタイムスタンプではなく、意味内容に基づいてメディアコンテンツを正確に取得できます。
できること
- 1特定の会話内容を見つける誰かが話した正確な言葉を入力することで、動画内の瞬間を特定します。
- 2視覚的なアクションを検索する画面上で発生している動きを説明することで、一連のイベントを特定します。
- 3繰り返し登場する人物を特定する動画ファイル全体に複数回登場する特定の顔をグループ化して検索します。
- 4音声イベントを取得するメディアライブラリ内から、犬の鳴き声や交通騒音などの特定の音を見つけます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能grayhatdevelopers/vidxp is public and reachablegithub.com/grayhatdevelopers/vidxp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-12github.com/grayhatdevelopers/vidxp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るFind the moment, not the timestamp
VidXP makes one video—or an entire collection—searchable by meaning:
- Speech search: type what you remember someone saying and jump to the matching moments.
- Scene search: describe what appeared on screen and find the closest visual matches.
- Action search: describe something that happens over several seconds.
- Actor matching: find recurring faces within a video and export a highlighted video for a selected group.
Use it to search years of family videos, add video search to an editing workflow, or let an AI agent answer questions using evidence from your own video library. Your videos can stay on your machine.
Start here
Choose the setup that fits how you want to use VidXP.
1. Desktop app
Download the installer for Windows, Apple Silicon macOS, or Linux from GitHub Releases.
Connect an existing VidXP installation or let the desktop app manage an isolated runtime for you. See the Desktop installation instructions for supported setup options.
2. CLI and local AI assistants
For commands, scripts, and local AI assistants, install uv, then run:
# Install the CPU edition
uv tool install --python 3.14 --torch-backend cpu "vidxp[local-worker,mcp]"
# Check FFmpeg, download models, and verify the installation
vidxp init
vidxp prepare
vidxp doctor
# Print the settings for a local MCP client
vidxp mcp-config
Add the browser interface with:
uv tool install --python 3.14 --torch-backend cpu \
"vidxp[local-worker,mcp,frontend]"
vidxp ui
See the installation guide for client-specific MCP configuration, the HTTP API, and remote server setup.
3. Docker for a server
Run the published all-in-one image on a home server or another single machine:
# Download the search models into the persistent volume
docker run --rm -it \
-v vidxp-data:/var/lib/vidxp \
ghcr.io/grayhatdevelopers/vidxp:latest \
vidxp prepare
# Start the browser interface
docker run --rm --init \
-p 8501:8501 \
-v vidxp-data:/var/lib/vidxp \
ghcr.io/grayhatdevelopers/vidxp:latest
For a long-lived server, pin a published version instead of latest. For a
Coolify deployment, use the published -control and -worker images with
compose.coolify.yaml—no repository build is required.
See the Coolify guide for the complete setup.
What you can do today
- Build searchable libraries from individual videos or whole collections.
- Find speech, sound events, visual scenes, and multi-frame actions by description.
- Ask grounded questions and inspect the supporting boards, frames, or clips.
- Group recurring faces and render highlighted actor overlays.
- Keep personal, client, or project libraries separate.
- Use VidXP through the desktop app, browser, CLI, MCP, or HTTP API.
A first search
The browser app guides you through importing and indexing. The same flow from the command line is:
# Add a video
vidxp media import samplevideo.mp4 --json
# Index the returned media ID
vidxp index create <media-id>
# Find a visual moment
vidxp search scene "a yellow taxi on a city street"
# Find an action or event
vidxp search action "a person opens a door and walks outside"
# Find a sound event
vidxp search sound "a dog barking over traffic noise"
# Find something that was said
vidxp search speech "the bread just came out of the oven"
Results include the source video, timestamps, match score, and the evidence
used to find the moment. Add --media-id <media-id> to search only one video.
Run vidxp --help or vidxp <command> --help for the full command reference.
For applications and AI agents
Use the Python package to add selected VidXP capabilities directly to an application, or use the HTTP API when VidXP runs as a service.
MCP lets AI clients add and index videos, search a library, ask grounded questions, and return inspectable evidence such as boards, frames, and clips. A local client can start VidXP as a program on the same computer. A hosted client connects to a deployed VidXP server.
Codex plugin and skills
VidXP is distributed as a Codex plugin through a Git marketplace hosted in this GitHub repository. It includes three reusable workflows:
- install Desktop or the CLI and connect Codex;
- ingest and index videos; and
- find moments and return inspectable evidence.
Paste this into Codex:
Add https://github.com/grayhatdevelopers/vidxp as a Git plugin marketplace, install the VidXP plugin, then use its $vidxp-install skill to set up VidXP on this computer.
VidXP Desktop can perform the same setup from its Set up in Codex button.
Compatible AI clients can show an interactive upload and evidence-review view. Clients without that interface still receive the same workflow results through ordinary MCP tools.
- Python, HTTP, and MCP installation
- Local HTTP API and MCP server
- Premiere Pro extension
- ChatGPT and Codex plugin integration
- Optional capability packages
- Coolify server setup
Downloads and storage
First setup downloads only the models needed for the capabilities you select. VidXP shows the download size and destination before it starts.
The Desktop-managed Python runtime and its selected dependencies can use approximately 3 GiB.
| Capability | Approximate model download |
|---|---|
| Speech search | 2.64 GiB |
| Sound event search | 0.94 GiB |
| Scene search | 1.43 GiB |
| Action search | 0.93 GiB |
| Actor matching | 37 MiB |
A full local Desktop setup with every search capability uses approximately 9.0 GiB. Leave additional temporary space during installation and for indexes, source videos, and exported results.
By default, the CLI and desktop app share the same VidXP data directory:
| Platform | Default location |
|---|---|
| Windows | %LOCALAPPDATA%\VidXP |
| macOS | ~/Library/Application Support/VidXP |
| Linux | ${XDG_DATA_HOME:-~/.local/share}/VidXP |
Docker keeps the same data in the vidxp-data volume shown above.
Product roadmap
The next product improvements are focused on:
- labeling actor groups and matching the same person across different videos;
- more reliable face tracking across angle, lighting, motion, and occlusion;
- connecting visible people with the dialogue they are speaking;
- better search ranking, time ranges, and natural-language questions across a whole library;
- richer previews, timelines, filters, saved searches, and result playback;
- easier organization for large personal and project video collections;
- faster indexing and supported GPU acceleration; and
- smoother desktop updates, repair, and model management.
VidXP is in beta. Feedback about search quality, actor workflows, and real video-library use cases is especially useful.
Help and project links
- Installation and troubleshooting
- Desktop development
- Coolify deployment
- Changelog
- Issue tracker
- MIT license
Contributing
Contributions are welcome. Read the contribution guide before opening a pull request.
Credits
VidXP began as a student research project by:
The research was conducted with Dr Shahab Tahzeeb at NED University of Engineering and Technology and Saad Bazaz at Grayhat.
VidXP is now built by Grayhat and maintained by community contributors.
Email: info@grayhat.studio
VidXP MCPのよくある質問
VidXPでは動画内の何を検索できますか?
話された言葉、音のイベント、視覚的なシーン、複数フレームにわたるアクション、および繰り返し登場する顔を検索できます。各検索結果には、ソース動画、タイムスタンプ、マッチスコア、および裏付けとなるエビデンスが含まれます。
MCP経由でAIクライアントからVidXPを使用するにはどうすればよいですか?
mcp extraをインストールした後、vidxp mcp-configを実行して、ローカルのMCPクライアント用の設定を出力します。MCPクライアントは、動画の追加とインデックス作成、ライブラリの検索、および根拠に基づいた質問を行うことができます。
動画が自分のマシンから外部へ送信されることはありますか?
いいえ、VidXPはローカルファーストであり、動画は自身のマシンに保持されます。ホストされたクライアントを使用する場合は、デプロイされたVidXPサーバーに接続します。
検索モデルにはどの程度のディスク容量が必要ですか?
モデルのダウンロードサイズは、アクターマッチングの約37 MiBから、音声検索の2.64 GiBまで多岐にわたります。すべての機能を含むフルローカルセットアップでは、約9.0 GiBを使用します。
VidXPを使用するためにAPIキーやログインは必要ですか?
READMEには、デスクトップアプリ、CLI、MCP、またはHTTP APIを通じてローカルでVidXPを使用するためのAPIキー、トークン、またはOAuthログインに関する記載はありません。

