Gst Mcp

gst-mcp

GStreamer のイントロスペクションとパイプライン開発のための MCP サーバーです。LLM が GStreamer のエレメント、caps、パイプラインの構築を理解するのに役立ちます。

インストール

PyPI から（推奨）

# Using uvx (no install needed)
uvx gst-mcp

# Or install globally
uv tool install gst-mcp

# Or with pip
pip install gst-mcp

ソースから

git clone https://github.com/wizenink/gst-mcp
cd gst-mcp
uv sync

システム要件

• Python 3.13+
• 開発ファイルを含む GStreamer 1.0
• PyGObject（GStreamer の Python バインディング）

Arch Linux の場合：

sudo pacman -S gstreamer gst-plugins-base gst-plugins-good python-gobject

Ubuntu/Debian の場合：

sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good python3-gi

Claude Code での使用方法

~/.claude/settings.json に追加します：

{
  "mcpServers": {
    "gstreamer": {
      "command": "uvx",
      "args": ["gst-mcp"]
    }
  }
}

ソースからインストールした場合：

{
  "mcpServers": {
    "gstreamer": {
      "command": "uv",
      "args": ["--directory", "/path/to/gst-mcp", "run", "gst-mcp"]
    }
  }
}

利用可能なツール

レジストリのイントロスペクション

• list_elements - カテゴリ（source、sink、decoder、encoder、muxer、demuxer、filter、parser）別にエレメントを一覧表示します
• get_element_info - エレメントの詳細情報（プロパティ、パッド、caps テンプレート、シグナル）を取得します
• list_plugins - インストール済みの GStreamer プラグインをすべて一覧表示します
• get_plugin_info - プラグインの詳細と、そのエレメントを取得します
• search_elements - 名前、説明、または caps でエレメントを検索します

Caps とネゴシエーション

• parse_caps - caps 文字列を構造化情報に解析します
• check_caps_compatible - 2 つの caps が交差可能かどうかを確認します
• check_elements_can_link - パッドの caps に基づいて、エレメント同士をリンクできるかどうかを確認します
• suggest_converter - 互換性のないエレメントに使えるコンバーターエレメントを提案します

パイプラインツール

• validate_pipeline - エラーの提案を添えてパイプラインの構文を検証します
• run_pipeline - パイプラインを実行します（タイムアウト付きの同期実行、または非同期実行）
• get_pipeline_status - 実行中のパイプラインのステータスを取得します
• stop_pipeline - 実行中のパイプラインを停止します
• list_running_pipelines - 実行中のパイプラインをすべて一覧表示します
• get_pipeline_graph - パイプラインの DOT グラフを生成します

ドキュメントとサンプル

• get_examples - カテゴリ（再生、トランスコード、ストリーミング、キャプチャ、エフェクト、テスト、分析）別にパイプラインのサンプルを取得します
• fetch_online_docs - GStreamer のウェブサイトからエレメントのドキュメントを取得します

質問の例

Claude に質問できます：

• 「H.264 動画をデコードできるエレメントはどれですか？」
• 「videotestsrc を x264enc に直接リンクできますか？」
• 「MP4 を WebM にトランスコードするパイプラインを作成するにはどうすればよいですか？」
• 「compositor エレメントにはどのようなプロパティがありますか？」
• 「RTMP ストリーミングパイプラインのサンプルを見せてください」

ライセンス

MIT