OBS WebSocket API で OBS Studio を制御できるモデルコンテキストプロトコル(MCP)サーバーです。

概要

このMCPサーバーは、OBS Studio上でのプログラム制御でAIエージェント(Claudeのような)を提供し、自動シーンの切り替え、録画制御、ストリーミング管理、およびより自然言語の相互作用を介してより多くのことができます。

##特徴

• 81 MCPツール: 9つのツールグループでOBS Studio操作を総合制御
• シーン管理: リスト、スイッチ、作成、削除 OBS シーン -Scene Presets: ソースの可視設定を保存および復元 -Recording Control: スタート、停止、一時停止、再開、およびモニター録画 -Streaming Control: ストリーミングを開始、停止、監視
• ソース管理: ソースの可視性のリストと制御 -オーディオコントロール: 入力ミュートとボリュームレベルを管理する -スクリーンショットソース:定期的な画像キャプチャでAIビジュアルモニタリング -アジェンティックシーンデザイン:ソース(テキスト、画像、色、ブラウザ、メディア)の作成と操作
• ヘルプ&ディスカバリー:トピックベースのガイダンスを備えた組み込みヘルプツール
• 状態監視: OBS接続と運用状況の問い合わせ

agentic-obs

A Model Context Protocol (MCP) server that enables AI assistants to control OBS Studio through the OBS WebSocket API.

Overview

This MCP server provides AI agents (like Claude) with programmatic control over OBS Studio, enabling automated scene switching, recording control, streaming management, and more through natural language interactions.

Features

• 81 MCP Tools: Comprehensive control over OBS Studio operations in 9 tool groups
• Scene Management: List, switch, create, and remove OBS scenes
• Scene Presets: Save and restore source visibility configurations
• Recording Control: Start, stop, pause, resume, and monitor recording
• Streaming Control: Start, stop, and monitor streaming
• Source Management: List and control source visibility
• Audio Control: Manage input mute and volume levels
• Screenshot Sources: AI visual monitoring with periodic image capture
• Agentic Scene Design: Create and manipulate sources (text, image, color, browser, media)
• Help & Discovery: Built-in help tool with topic-based guidance
• Status Monitoring: Query OBS connection and operational status
• Automation Rules: Event-triggered actions and scheduled tasks for hands-free OBS control
• 4 MCP Resources: Scenes, screenshots, screenshot URLs, and presets exposed as resources
• 14 MCP Prompts: Pre-built workflows for common tasks and diagnostics
• MCP Completions: Autocomplete for prompt arguments and resource URIs
• Claude Skills: Shareable skill packages for advanced AI orchestration
• TUI Dashboard: Terminal interface for status, config, and history (--tui flag)
• Web Dashboard: Browser-based dashboard at http://localhost:8765/

Prerequisites

• Go 1.25.5+ - Download
• OBS Studio 28+ - Includes built-in WebSocket server
• Git - For version control

Installation

Option 1: Install with Go (Recommended)

go install github.com/ironystock/agentic-obs@latest

This installs the agentic-obs binary to your $GOPATH/bin directory.

Option 2: Build from Source

# Clone the repository
git clone https://github.com/ironystock/agentic-obs.git
cd agentic-obs

# Build with Make (recommended - includes version info)
make build

# Or build directly with Go
go build -o agentic-obs .

# Verify the build
./agentic-obs --version

For cross-platform builds, release automation, and advanced build options, see docs/BUILD.md.

Configure OBS Studio

1. Open OBS Studio
2. Go to Tools → WebSocket Server Settings
3. Enable the WebSocket server (default port: 4455)
4. Set a password (optional but recommended)
5. Note your connection details

Usage

Running the Server

# MCP server mode (default) - if installed via go install
agentic-obs

# TUI dashboard mode - terminal interface for monitoring
agentic-obs --tui
agentic-obs -t

# Or run directly from source
go run main.go