Media Context Mcp

AI アシスタントに目と耳を与えましょう。
動画、音声、画像をローカルで、エディター内から直接分析できます。

インストール  ·  機能  ·  モード  ·  使用例  ·  ツール  ·  オプション  ·  ドキュメント

LLM はテキストを読み、1 枚の画像をざっと見ることはできますが、動画を見たり音声を聞いたりすることはできません。media-context-mcp はそのギャップを埋めます。ファイルまたはリンクを渡すと、キーフレーム、文字起こし、画面上のテキストなど、モデルがそのまま使えるコンテキストを、すべてお使いのマシン上で生成します。何もアップロードされません。

_{10 秒のクリップは、モデルが順番に読み取れる、すっきりした 1 枚のコンタクトシートになります。静止画が何百枚にもなることはありません。}

🚀 インストール

2 つの手順で完了します。サーバーを追加し、そのサーバーが使うローカルヘルパーをインストールします。

1 · クライアントにサーバーを追加する

# Claude Code
claude mcp add media-context -- npx -y media-context-mcp

起動コマンドは常に npx -y media-context-mcp です。お使いのクライアントを選んでください。

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "servers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "mcpServers": {
    "media-context": { "command": "npx", "args": ["-y", "media-context-mcp"] }
  }
}

{
  "context_servers": {
    "media-context": { "command": { "path": "npx", "args": ["-y", "media-context-mcp"] } }
  }
}

[mcp_servers.media-context]
command = "npx"
args = ["-y", "media-context-mcp"]

ヒント： Claude Code では、プラグインとしてインストールすることもできます。/plugin marketplace add vishalguptax/media-context-mcp を実行し、次に /plugin install media-context を実行します。チームで共有するには、プロジェクト単位でインストールするために --scope project（.mcp.json を書き込みます）を指定するか、リポジトリに .cursor/mcp.json をコミットします。

2 · ローカルヘルパーをインストールする

1 つのコマンドで、OS のパッケージマネージャーを使ってサーバーが利用するものをすべてセットアップできます。

npx media-context-mcp setup          # core: keyframes, links, on-screen text
npx media-context-mcp setup --audio  # also enable transcription

その後、サーバーがヘルパーを自動的に検出するため、追加の設定は不要です。check_media_deps を実行すると準備状況を確認でき、setup --uninstall を実行すると削除できます。（手動でインストール →）

3 · 質問する

「demo.mp4 を要約してください。」

✨ 機能

🎞️ モード

analyze_media は音声と画像を自動検出します。動画の場合は、フレームのサンプリング方法を選択できます。

💬 例

自然な言葉で質問するだけで、アシスタントが適切なオプションを選びます。

🧰 ツール

すべての呼び出しはローカルで実行され、終了後に後片付けを行います。

⚙️ オプション

アシスタントが自動で入力しますが、「フィルムストリップモードを使って」「ツールバーに合わせてトリミングして」のように指定することもできます。

❓ FAQ

LLM は動画を視聴できますか？ 直接はできません。モデルが入力として受け取れるのは画像とテキストであり、動画ではありません。このサーバーは動画を、読み取り可能なフレームと文字起こしに変換します。

何かがアップロードされますか？ いいえ。すべてお使いのマシン上で実行されます。キーもクラウドも必要ありません。

どのクライアントが使えますか？ あらゆる MCP クライアントに対応しています — Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Cline、Kiro、Gemini CLI、JetBrains、Zed、Codex。

YouTube などのリンクにも対応していますか？ はい。

費用はいくらですか？ 無料のオープンソースです。

📋 要件

Windows、macOS、Linux 上で Node.js 18 以降が必要です。初回の npx media-context-mcp setup で、その他すべてがインストールされます。

🛠️ 開発

npm install
npm run build
npm test

Issue や PR を歓迎します — アーキテクチャについては使用ガイドをご覧ください。

📄 ライセンス

Apache-2.0 © Vishal Gupta