OBS MCP Server

OBS MCP サーバー

OBS WebSocket プロトコルを介して OBS を制御するツールを提供する、OBS Studio 用の MCP サーバーです。

機能

• OBS WebSocket サーバーに接続
• MCP ツールを介して OBS を制御
• 以下のツールを提供します：
  • 一般的な操作
  • シーンの管理
  • ソースの制御
  • シーンアイテムの操作
  • 配信と録画
  • トランジション

使い方

1. WebSocket サーバーを有効にして OBS Studio が実行されていることを確認します（ツール > WebSocket サーバー設定）。WS のパスワードを控えておきます。
2. 必要に応じて、環境変数に WebSocket パスワードを設定します：

export OBS_WEBSOCKET_PASSWORD="your_password_here"

3. MCP サーバーの設定を使用して、Claude デスクトップに MCP サーバーを追加します：

{
  "mcpServers": {
    "obs": {
      "command": "npx",
      "args": ["-y", "obs-mcp@latest"],
      "env": {
        "OBS_WEBSOCKET_PASSWORD": "<password_from_obs>"
      }
    }
  }
}

4. Claude を使って OBS を操作しましょう！

開発

この git リポジトリのコードを使ってサーバーをローカルで実行する場合は、次の手順を行います：

npm run build
npm run start

次に、Claude デスクトップを設定します：

{
  "mcpServers": {
    "obs": {
      "command": "node",
      "args": [
        "<obs-mcp_root>/build/index.js"
      ],
      "env": {
        "OBS_WEBSOCKET_PASSWORD": "<password_from_obs>"
      }
    }
  }
}

利用可能なツール

サーバーは、以下のカテゴリに分類されたツールを提供します：

• 一般ツール：バージョン情報、統計、ホットキー、スタジオモード
• シーンツール：シーンの一覧表示、シーンの切り替え、シーンの作成／削除
• ソースツール：ソース、設定、音量、ミュート／ミュート解除の管理
• シーンアイテムツール：シーン内のアイテムの管理（位置、表示状態など）
• 配信ツール：配信、録画、仮想カメラの開始／停止
• トランジションツール：トランジションと所要時間の設定、トランジションの実行

環境変数

• OBS_WEBSOCKET_URL：WebSocket URL（デフォルト：ws://localhost:4455）
• OBS_WEBSOCKET_PASSWORD：OBS WebSocket の認証に使用するパスワード（必要な場合）

必要条件

• Node.js 16+
• WebSocket サーバーが有効な OBS Studio 31+
• Claude デスクトップ

ライセンス

詳細については、LICENSE ファイルを参照してください。