argos-mcp

SamuraiBuddha/argos-mcp

3.1

If you are the rightful owner of argos-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Argos MCP is an AI-controlled server for OBS Studio, enabling natural language control over streaming and production tasks.

Argos MCP 👁️‍🗨️

An MCP server for OBS Studio - The all-seeing streaming controller. Scene management, source control, and production automation through AI.

Overview

Argos MCP transforms OBS Studio into an AI-controlled production studio. Named after the many-eyed giant of Greek mythology, it watches over all your sources, scenes, and streaming settings. Control everything with natural language:

  • "Switch to my gaming scene"
  • "Start recording but don't stream yet"
  • "Lower the game audio by 50%"
  • "Add a new browser source showing my alerts"

Features (Planned)

Core Functionality

  • 🎬 Scene Management - Switch, create, and modify scenes
  • 📹 Source Control - Add, remove, show/hide sources
  • 🎙️ Audio Mixing - Adjust levels, mute/unmute, apply filters
  • 📡 Stream Control - Start/stop streaming and recording

Advanced Features

  • 🎨 Filter Management - Apply and configure video/audio filters
  • 📊 Stats Monitoring - Stream health, dropped frames, bitrate
  • 🔄 Transition Control - Set transition types and durations
  • 📝 Text Updates - Modify text sources dynamically

Production Workflows

Enable complex production scenarios:

  • Automated Shows: Pre-programmed scene sequences
  • Dynamic Overlays: Update information in real-time
  • Smart Audio: Auto-ducking when you speak
  • Alert Integration: React to chat, donations, follows

Ecosystem Integration

The command center for your streaming setup:

  • Cyclops Integration: Camera changes trigger scene switches
  • LightFlows Integration: Scene changes update RGB lighting
  • LlamaBeats Integration: Music controls appear as sources

Installation

# Clone the repository
git clone https://github.com/SamuraiBuddha/argos-mcp.git
cd argos-mcp

# Install dependencies
npm install

# Configure Claude desktop
# Add to claude_desktop_config.json:
{
  "argos": {
    "command": "node",
    "args": ["path/to/argos-mcp/index.js"]
  }
}

Usage Examples

Basic Control

"Mute my microphone"
"Switch to the intermission scene"
"Start streaming to Twitch"
"Show the webcam"

Advanced Automation

"Create a starting soon scene with a countdown"
"Set up picture-in-picture for the gameplay"
"Add all my alerts to the current scene"
"Configure a green screen for my camera"

Architecture

Built on OBS WebSocket API v5:

  • Real-time bidirectional communication
  • Event subscriptions for reactive automation
  • Full access to OBS functionality
  • Low latency scene switching

Supported Sources

  • 🖥️ Display/Window/Game Capture
  • 📹 Video Capture Devices
  • 🌐 Browser Sources
  • 🖼️ Image/Media Sources
  • 📝 Text Sources
  • 🎨 Color Sources
  • 🎵 Audio Input/Output

Requirements

  • OBS Studio 28+ with WebSocket server enabled
  • Node.js 18+
  • OBS WebSocket plugin (built-in on OBS 28+)

Why "Argos"?

In Greek mythology, Argos Panoptes was a giant with a hundred eyes, making him an excellent watchman. Similarly, Argos MCP watches over all aspects of your OBS setup, managing multiple sources and scenes simultaneously.

Related Projects

License

MIT