framegrab-mcp-server

framegrab-mcp-server

概要

カメラや動画ストリームから画像をキャプチャするための Model Context Protocol（MCP）サーバーです。実際の画像キャプチャには、framegrab ライブラリを使用します。

このサーバーは、ウェブカメラ、USB カメラ、RTSP ストリーム、YouTube のライブ配信、その他 framegrab ライブラリがサポートする動画ソースから画像をキャプチャするために使用できます。

この MCP サーバーはまだ開発初期段階です。サーバーの開発と改善を続けるなかで、機能や利用可能なツールは変更・拡張される可能性があります。

ツール

Framegrab MCP サーバーでは、次のツールを利用できます。

• create_framegrabber：設定オブジェクトから新しいフレームグラバーを作成し、利用可能なグラバーに追加します。
• grab_frame：指定されたフレームグラバーからフレームを取得し、指定した形式（png、jpg、webp）の画像として返します。
• list_framegrabbers：利用可能なすべてのフレームグラバーを名前順に並べて一覧表示します。
• get_framegrabber_config：特定のフレームグラバーの設定を取得します。
• set_framegrabber_config：特定のフレームグラバーの設定オプションを更新します。
• release_framegrabber：フレームグラバーを解放し、利用可能なグラバーから削除します。

リソース

Framegrab MCP サーバーでは、次のリソースを利用できます。

• framegrabbers：利用可能なすべてのフレームグラバーを名前順に並べて一覧表示します。

設定

Claude Desktop での使用

これを claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "framegrab": {
      "command": "uvx",
      "args": [
        "framegrab-mcp-server"
      ]
    }
  }
}

Zed での使用

次の内容を Zed の settings.json に追加します：

{
  "context_servers": {
    "framegrab": {
      "command": {
        "path": "uvx",
        "args": [
          "framegrab-mcp-server"
        ]
      }
    }
  }
}

（実験的）フレームグラバーの自動検出を有効にする

環境変数に ENABLE_FRAMEGRAB_AUTO_DISCOVERY="true" を設定すると、フレームグラバー（ウェブカメラや USB カメラなど）の自動検出が有効になります。検出されたフレームグラバーは、自動的に利用可能なフレームグラバーの一覧に追加されます。

自動検出が有効な場合は、FRAMEGRAB_RTSP_AUTO_DISCOVERY_MODE を変更して、RTSP の自動検出方法を設定することもできます。デフォルトでは "off" に設定されており、RTSP の自動検出は無効になっています。徹底的に自動検出を行うには、"complete_fast" に設定してください。

{
  "mcpServers": {
    "framegrab": {
      "command": "uvx",
      "args": [
        "framegrab-mcp-server"
      ],
      "env": {
        "ENABLE_FRAMEGRAB_AUTO_DISCOVERY": "true",
        "FRAMEGRAB_RTSP_AUTO_DISCOVERY_MODE": "complete_fast"
      }
    }
  }
}

これにより、サーバーの起動時間が長くなります。