OBS MCP

OBS MCP は、MCP クライアントに OBS Studio の最新かつ検査可能なインターフェースを提供します。シーン、ソース、オーディオ、トランジション、フィルター、録画、配信、キャンバス、および OBS WebSocket v5 のリクエストサーフェスの残り全体に対して、155 のツールを公開します。

このサーバーは MCP 2026-07-28 を対象に構築されており、2025 年時代のレガシークライアントも引き続き受け付けます。MCP のディスカバリーは OBS が閉じている間も利用可能で、OBS が戻ったときにサーバーはバックグラウンドで再接続します。

仕組み

MCP client  <-- stdio -->  OBS MCP  <-- WebSocket v5 -->  OBS Studio

OBS MCP は独立した Node.js プロセスとして実行されます。OBS にパッチを当てたり、OBS プラグインを必要としたりしません。OBS Studio に組み込まれた WebSocket サーバーを使用します。MCP はツールのディスカバリー、スキーマ、結果、承認ヒントを処理します。OBS WebSocket はライブのアプリケーション状態を処理します。

Related MCP server: obs-mcp-server

カバーされる範囲

• 現在の OBS Studio ソースツリーで固定されている OBS WebSocket プロトコルリビジョンの全 147 リクエストタイプ

• すべてのツールに対する明示的な読み取り専用、破壊的、冪等、オープンワールドの注釈

• 接続された OBS インスタンスがアドバタイズするリクエストに対する実行時機能チェック

• obs-describe-request によるプロトコル検査

• バンドルされた OBS プロトコル内のリクエストに限定され、クライアント承認のために破壊的とマークされた汎用 obs-call-request エスケープハッチ

• ツールインベントリをプライベート SDK 内部ではなく MCP 経由で生成する再現可能な .mcpb ビルド

明示的なツールが通常のインターフェースです。汎用リクエストツールは、新しく追加された OBS 操作がより使いやすいラッパーを受け取る前に使用できるように用意されています。

要件

• Node.js 20.19 以降

• WebSocket サーバーが有効な OBS Studio 28 以降

• MCP 2026-07-28 または互換性のあるレガシープロトコルをサポートする MCP クライアント

OBS には WebSocket v5 が含まれています。ツール > WebSocket サーバー設定で有効にしてください。新しい OBS リクエストは、接続されたバージョンがアドバタイズしている場合にのみ利用できます。サポートされていない呼び出しは、説明付きのエラーを返します。

ソースからのインストール

この独立したリポジトリには、まだ独自の npm リリースがありません。それまでは、ローカルチェックアウトから実行してください:

git clone https://github.com/Tom-R-Main/OBS-MCP.git
cd OBS-MCP
npm ci
npm run check

次に、MCP クライアントをビルドされたエントリポイントに向けます:

{
  "mcpServers": {
    "obs": {
      "command": "node",
      "args": ["/absolute/path/to/OBS-MCP/build/index.js"],
      "env": {
        "OBS_WEBSOCKET_PASSWORD": "<password-from-obs>"
      }
    }
  }
}

OBS がデフォルト以外のアドレスを使用する場合は、環境ブロックに OBS_WEBSOCKET_URL を追加します。

接続の確認

OBS を開き、新しいエージェントセッションを開始して、次のように尋ねます:

OBS の接続を確認してください。OBS のバージョン、現在のシーン、配信ステータス、録画ステータスを報告してください。何も変更しないでください。

クライアントは読み取り専用ツールのみを要求し、OBS からライブの値を返すはずです。ツールのディスカバリーは機能するが、プロンプトが OBS が切断されていると報告する場合は、MCP サーバーを実行したまま OBS を起動してください。再接続はバックグラウンドで行われます。

MCPB パッケージのインストール

デスクトップパッケージをローカルでビルドします:

npm run pack

このコマンドはサーバーを再ビルドし、MCP 経由で公開ツールリストを読み取り、本番専用依存関係を分離されたステージングディレクトリにインストールし、マニフェストを検証して、次のものを書き出します:

dist/obs-studio.mcpb

そのファイルを MCPB 互換のデスクトップクライアントで開きます。パッケージは OBS WebSocket の URL とパスワードを要求します。

設定

サーバーはパスワードを決して出力しません。接続とプロトコルの診断は stderr に書き込まれるため、stdout は MCP メッセージ用に予約されたままです。

ツールサーフェス

155 のツールは、より小さな意見ベースのワークフローではなく、OBS プロトコルを中心に編成されています:

• サーバーステータス、バージョン情報、統計、ホットキー、スタジオモード

• シーン、グループ、ソース、フィルター、シーンアイテム

• 入力設定、オーディオトラック、音量、ミュート状態、メディアコントロール、デインターレース

• 録画、配信、リプレイバッファー、仮想カメラ、出力設定

• トランジション、トランジションオーバーライド、トランジションカーソル、T-Bar

• キャンバス、スクリーンショット、プロファイル、シーンコレクション、永続データ

• プロトコル説明と保護された汎用リクエストフォールバック

ツールのディスカバリーは OBS 接続なしで機能します。OBS を必要とする呼び出しは、WebSocket 接続が準備できるまで MCP エラーを返します。

適した用途

OBS MCP は、すでに明確な結果がある運用作業に適しています: シーンコレクションの検査、ソースの作成や配置、オーディオ状態の変更、シーンの切り替え、スクリーンショットの取得、出力ステータスの確認、または再現可能な録画セットアップの実行などです。

視覚的または編集上の判断を置き換えるものではありません。フレーミング、色、トランジションのタイミング、オーディオバランス、配信開始の決定には、結果を見て聞く人が必要です。

安全性と承認

すべてのツールは、4 つの MCP 動作ヒントすべてを公開します。読み取り専用の検査は状態変更から分離され、より広い影響を持つアクションは、適切に破壊的またはオープンワールドとしてマークされます。

次のツールの承認には特に注意してください:

• 配信、録画、仮想カメラ、リプレイバッファー、またはその他の出力の開始または停止

• プロファイルまたはシーンコレクションの切り替え

• ホットキーのトリガーまたは OBS UI 要素との対話

• ベンダーリクエストの呼び出し

• ファイルの保存または汎用 obs-call-request フォールバックの使用

obs-call-request は、バンドルされた OBS プロトコル内のリクエストタイプのみを受け入れますが、そのペイロードは意図的に汎用です。クライアントが馴染みのない操作を安全なものとして黙って扱わないように、常に破壊的かつオープンワールドとしてアドバタイズされます。

トラブルシューティング

ツールは表示されるが、OBS 呼び出しが失敗する: OBS が開いていて、WebSocket サーバーが有効になっていることを確認してください。MCP プロセスは接続を再試行している間も利用可能です。

認証が失敗する: ツール > WebSocket サーバー設定 からパスワードを OBS_WEBSOCKET_PASSWORD にコピーし、MCP サーバープロセスを再起動してください。

エージェントがツールを表示できない: エージェントセッションまたは MCP ホストを再起動して、新しい stdio 接続を作成し、ツールリストを再読み込みしてください。

リクエストがサポートされていない: 接続された OBS ビルドがその WebSocket リクエストをアドバタイズしていません。そのバージョンでサポートされている操作を使用するか、OBS を更新してください。

プロセスが終了するか、プロトコルエラーを発する: stderr を確認してください。stdout は MCP トラフィック用に予約されており、通常のアプリケーションログにリダイレクトしないでください。

開発

npm ci
npm run build
npm test
npm run validate:manifest

完全なローカルゲートを次で実行します:

npm run check

テストは、OBS WebSocket ハンドシェイクとリクエストの相関、同時接続試行、機能ゲーティング、OBS リクエストの完全なパリティ、決定論的なツールディスカバリー、注釈、レガシーと MCP 2026-07-28 の両方のネゴシエーションをカバーします。

TypeScript ポリシー

アプリケーションは TypeScript 7.0.2 でビルドされ、TypeScript コンパイラ API をインポートしません。将来のジェネレーター、リンター、またはビルドツールがプログラムによるコンパイラアクセスを必要とする場合は、アプリケーションコンパイラを TypeScript 7 に保ちながら、そのツールを TypeScript 6 に保ってください。TypeScript 7.0 にはプログラム API が同梱されていません。Microsoft は、TypeScript 7.0 リリースノート でサイドバイサイドの TypeScript 6 互換パッケージを文書化しています。

プロトコルベースライン

このリビジョンは、次の正確なソースに対してチェックされました:

• MCP 仕様: cbd57657

• MCP TypeScript サーバーおよびクライアント SDK: 2.0.0

• OBS Studio: 0043697f

• OBS WebSocket: 1ef34bf4、その OBS Studio チェックアウトによって固定されたリビジョン

生成されたプロトコルファイルは docs/ にあります。テストは、ツールモジュールが使用するすべてのリクエストをバンドルされたプロトコルと比較するため、廃止されたリクエスト名と欠落したラッパーはローカルで失敗します。

プロジェクトの歴史

このプロジェクトは Roy Shilkrot の obs-mcp から始まり、Zeke Sikelianos による上流の作業を含みます。また、Jag-k の MCPB パッケージングと registerTool 移行作業も保存しています。彼らの元のコミットと著作者は Git 履歴に残っています。

ライセンス

OBS MCP は GPL-2.0-only でライセンスされています。公開された npm および MCPB パッケージには、対応する TypeScript ソースとビルドスクリプトが含まれています。LICENSE と NOTICE.md を参照してください。