プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

media-context (mctx)

作者:mollymogiバージョン 0.1.2i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.mollymogi/media-context

インストール方法

できること

Keep images, video & audio out of coding agent contexts — local FFmpeg + zero extra API cost.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー キー不要
  • カテゴリ デザイン・画像・音声

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

作者:pbakaus★ 113,5361 個の skill

Skill · 手順書

diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

作者:cathrynlavery★ 68,7131 個の skill

Skill · 手順書

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

作者:zarazhangrui★ 32,6391 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア12/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

media-context (mctx) をインストールして。https://mcp.popnx.com/i/mollymogi-media-context.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月19日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server media-context (mctx) を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "media-context": { "command": "uvx", "args": [ "media-context", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、media-context (mctx) のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "media-context": {
          "command": "uvx",
          "args": [
            "media-context",
            "mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    media-context (mctx) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が media-context (mctx) を使っていると言うか、回答に media-context (mctx) のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • MCTX_FALLBACK_CHAIN 省略可能なカンマ区切りのフォールバックチェーン。例: agy:gemini-4-neon-medium,claude:sonnet,codex
    英語の原文を見るOptional comma-separated fallback chain, e.g. agy:gemini-4-neon-medium,claude:sonnet,codex
  • MCTX_COOLDOWN_SECONDS クォータまたは容量の失敗後のクールダウン時間(秒)(デフォルト: 300)
    英語の原文を見るCooldown duration in seconds after quota/capacity failures (default: 300)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ media-context (mctx) につなげません

media-context (mctx) はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · media-context (mctx) につなげるアプリを使う

  • 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · デザイン・画像・音声 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server media-context (mctx) を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user media-context -- uvx media-context mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、media-context (mctx) のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user media-context -- uvx media-context mcp
  4. Claude Code で /mcp と入力

    media-context (mctx) が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    media-context (mctx) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が media-context (mctx) を使っていると言うか、回答に media-context (mctx) のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • MCTX_FALLBACK_CHAIN 省略可能なカンマ区切りのフォールバックチェーン。例: agy:gemini-4-neon-medium,claude:sonnet,codex
    英語の原文を見るOptional comma-separated fallback chain, e.g. agy:gemini-4-neon-medium,claude:sonnet,codex
  • MCTX_COOLDOWN_SECONDS クォータまたは容量の失敗後のクールダウン時間(秒)(デフォルト: 300)
    英語の原文を見るCooldown duration in seconds after quota/capacity failures (default: 300)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server media-context (mctx) を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "media-context": { "command": "uvx", "args": [ "media-context", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、media-context (mctx) のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    media-context (mctx) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が media-context (mctx) を使っていると言うか、回答に media-context (mctx) のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • MCTX_FALLBACK_CHAIN 省略可能なカンマ区切りのフォールバックチェーン。例: agy:gemini-4-neon-medium,claude:sonnet,codex
    英語の原文を見るOptional comma-separated fallback chain, e.g. agy:gemini-4-neon-medium,claude:sonnet,codex
  • MCTX_COOLDOWN_SECONDS クォータまたは容量の失敗後のクールダウン時間(秒)(デフォルト: 300)
    英語の原文を見るCooldown duration in seconds after quota/capacity failures (default: 300)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server media-context (mctx) を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "media-context": { "type": "stdio", "command": "uvx", "args": [ "media-context", "mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、media-context (mctx) のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    media-context (mctx) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が media-context (mctx) を使っていると言うか、回答に media-context (mctx) のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • MCTX_FALLBACK_CHAIN 省略可能なカンマ区切りのフォールバックチェーン。例: agy:gemini-4-neon-medium,claude:sonnet,codex
    英語の原文を見るOptional comma-separated fallback chain, e.g. agy:gemini-4-neon-medium,claude:sonnet,codex
  • MCTX_COOLDOWN_SECONDS クォータまたは容量の失敗後のクールダウン時間(秒)(デフォルト: 300)
    英語の原文を見るCooldown duration in seconds after quota/capacity failures (default: 300)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?media-context (mctx) を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user media-context -- uvx media-context mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "media-context": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "media-context",
        "mcp"
      ]
    }
  }
}

自分で入力する値

  • MCTX_FALLBACK_CHAIN env
    省略可能なカンマ区切りのフォールバックチェーン。例: agy:gemini-4-neon-medium,claude:sonnet,codex
    英語の原文を見るOptional comma-separated fallback chain, e.g. agy:gemini-4-neon-medium,claude:sonnet,codex
  • MCTX_COOLDOWN_SECONDS env
    クォータまたは容量の失敗後のクールダウン時間(秒)(デフォルト: 300)
    英語の原文を見るCooldown duration in seconds after quota/capacity failures (default: 300)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
0.1.2
レジストリ公開日i
2026年11月19日
コードの最終更新i
2026年11月19日
作者
mollymogi
パッケージ
pypi: media-context
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント mollymogi で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mollymogi-media-context.svg)](https://mcp.popnx.com/en/servers/mollymogi-media-context)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

デザイン・画像・音声のほかのサーバーとの比較i

  • このカテゴリのほかの3358件のうち0%よりスターが多い
  • このカテゴリのほかの3358件のうち95%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3358件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

media-context (mctx)は安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.1.2)がレジストリに届いたのは昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

作者:heygen-com広く使われている★ 8.7万 リポジトリ全体のスター一昨日更新

クラウドで動く✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

作者:pascalorg広く使われている↓ 1037/週★ 2.6万 リポジトリ全体のスター一昨日更新

パソコンでもクラウドでも✓ 提供元 · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

作者:jgraph広く使われている★ 58603 日前更新

クラウドで動く✓ 提供元 · draw.ioPopNx チームが実際に試用

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

作者:figma広く使われている★ 221313 か月前更新

クラウドで動く✓ 提供元 · mcp.figma.com
似たものと比べる
これ
media-context (mctx)
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいいいえいいえはいいいえ
基本チェック3/34/45/54/44/44/4
ライセンスMITApache-2.0MITApache-2.0–MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

media-context (mctx)

context-mode + rtk for Images, Video & Audio

Keep heavy media out of your coding agent's context window — local-first, zero extra API cost, works across Antigravity (`agy`), Claude Code, Codex, OpenCode, `dsh`, and any CLI.

🌐 English | 简体中文


Context & Token Savings (Before vs. After)

Metric (30 Images + 10 Audio Clips · 12 Turns)Before (Raw Read / read_file)After (With mctx)Delta (Δ)
Main Session Context Size~410,000 tokens~32,000 tokens-378,000 tokens (-92.2%)
Media Payload Pinned in History40 files (8.54 MB)0 files (0 B)-100% media bloat
Avg Time-to-First-Token (TTFT)285–324 s (~5.2 min/step)3–5 s-306 s/step (77× faster)
12-Turn Cumulative Model Wait~62 min~48 s-61.2 min saved
Extra Vision API BillingExtra API keys / per-token bill$0 (FFmpeg + your CLI sub)$0 extra

Why does this happen? Tools like rtk and context-mode protect you from large text logs, but every time an agent directly Reads a PNG, extracted video frame, or WAV clip into the main conversation, that heavy multimodal payload stays pinned in context for every subsequent turn.


How It Works (3-Stage Funnel)

Raw Video / Images / Audio

│ ├─► L1 · Local Zero-Token Tools (FFmpeg / FFprobe / Local Whisper) │ • mctx probe → compact JSON metadata + audio silence/clipping + black-frame checks │ • mctx sheet → stitch video or N frames into 1 timestamped contact sheet JPEG │ • mctx shrink → downscale huge 4K PNGs into lightweight JPEGs │ • mctx transcribe → offline local Whisper transcription (mlx-whisper / whisper-cpp) │ ├─► L2 · Stateless Subscription CLI Worker + Auto-Fallback + SQLite Cache ($0 extra API) │ • mctx inspect → spawns a disposable, stateless worker using your existing CLI │ (agy / claude -p / codex exec / opencode run), inspects the │ compressed sheet, caches by sha256 in SQLite, and returns │ ONLY concise text to your main session. │ └─► L3 · Cross-Client PreToolUse Guard Hook • mctx hook run → blocks accidental raw media Read/read_file (or auto-shrinks), with automatic MCTX_BYPASS=1 for internal workers.

  • Zero Python third-party dependencies (Python 3.9+ stdlib + ffmpeg/ffprobe).
  • One core, three interfaces: CLI (mctx), stdio MCP server (mctx mcp), and PreToolUse hook (mctx hook).

Quick Start

1. Install
git clone https://github.com/mollymogi/media-context.git

cd media-context pip install -e .

Or with pipx:

pipx install .

Check your local toolchain and detected subscription CLIs:

mctx doctor
2. CLI Usage (works in dsh, scripts, and every agent)
# Zero-token metadata + audio volume/silence + video black-frame check

mctx probe clip.mp4 --audio --black

Compress a video or folder of 30 frames into 1 timestamped 3x3 contact sheet

mctx sheet clip.mp4 --grid 3x3 --width 1280 mctx sheet ./frames/ --grid 3x3

Shrink a single large screenshot

mctx shrink hero_4k.png --max-side 1024

Stateless visual QA using your existing CLI subscription (zero main-session leak, SQLite cached)

mctx inspect clip.mp4 -q "Check if the character's hands deform or if any frame is corrupted." mctx inspect ./frames/ -q "Compare lighting consistency across frames" --backend claude

Offline local audio transcription (auto-detects mlx_whisper / whisper-cli / whisper)

mctx transcribe voiceover.wav -l zh

Check cumulative bytes & tokens saved

mctx stats

3. Connect via MCP (Antigravity, Claude Code, Codex, OpenCode, Magpie Hub)

Register mctx mcp as a stdio MCP server (only 6 compact tools exposed):

{

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

4. Default Models & Automatic Quota/Capacity Fallback

When the primary model hits quota limits (`429`), capacity congestion (`503 No capacity`), or auth expiry (`401`), mctx inspect automatically switches to the next available target in your fallback chain, places the failing model into a local SQLite cooldown (default 5 min), and prints a clear [mctx:fallback] notice:

mctx config init            # creates ~/.config/media-context/config.json

mctx config show # view active fallback chain & cooldowns mctx config reset-cooldown # clear cooldowns immediately

Example ~/.config/media-context/config.json:

{

"cooldown_seconds": 300, "fallback_chain": [ {"backend": "agy", "model": "gemini-4-neon-medium"}, {"backend": "claude", "model": "sonnet"}, {"backend": "codex", "model": ""}, {"backend": "opencode", "model": ""} ] }

5. Optional PreToolUse Guard Hook

Generate ready-to-paste hook snippets for your client:

mctx hook config antigravity --mode block

mctx hook config claude --mode block mctx hook config claude --mode shrink

  • --mode block: blocks raw image/audio/video Read / read_file and guides the agent to mctx probe / sheet / inspect (whitelisted mctx_sheet_* and mctx_shrink_* artifacts pass through).
  • --mode shrink: blocks raw audio/video, and transparently downscales oversized images before reading.

Environment Variables

VariableDescription
MCTX_FALLBACK_CHAINComma-separated fallback override (e.g. agy:gemini-4-neon-medium,claude:sonnet,codex)
MCTX_CONFIGCustom config JSON path (default: ~/.config/media-context/config.json)
MCTX_COOLDOWN_SECONDSCooldown window after quota/capacity errors (default: 300)
MCTX_BACKEND / MCTX_MODELSingle backend / model override
MCTX_HOMECache & SQLite directory (default: ~/.cache/media-context)
MCTX_BYPASS=1Bypass PreToolUse hook (automatically set inside mctx inspect workers)

License

MIT