Servidor OBS MCP

Un servidor MCP para OBS Studio que proporciona herramientas para controlar OBS a través del protocolo OBS WebSocket.

Características

• Conectarse al servidor OBS WebSocket

• Controlar OBS mediante herramientas MCP

• Proporciona herramientas para:

  • Operaciones generales

  • Gestión de escenas

  • Control de fuente

  • Manipulación de elementos de la escena

  • Transmisión y grabación

  • Transiciones

Related MCP server: MCP SSH Agent

Instalación

npm install
npm run build

Uso

1. Asegúrese de que OBS Studio se esté ejecutando con el servidor WebSocket habilitado (Herramientas > Configuración del servidor WebSocket). Anote la contraseña del servidor WebSocket.

2. Establezca la contraseña de WebSocket en la variable de entorno (si es necesario):

export OBS_WEBSOCKET_PASSWORD="your_password_here"

3. Ejecute el servidor OBS MCP para ver que puede compilarse y conectarse:

npm run build
npm run start

4. Proporcione su escritorio Claude con la configuración del servidor MCP:

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

5. ¡Usa a Claude para controlar tu OBS!

Herramientas disponibles

El servidor proporciona herramientas organizadas por categoría:

• Herramientas generales: Información de versión, estadísticas, teclas de acceso rápido, modo estudio

• Herramientas de escena: enumerar escenas, cambiar escenas, crear/eliminar escenas

• Herramientas de origen: Administrar fuentes, configuraciones, niveles de audio, silenciar/activar sonido

• Herramientas de elementos de escena: administre elementos en escenas (posición, visibilidad, etc.)

• Herramientas de transmisión: iniciar/detener transmisión, grabación, cámara virtual

• Herramientas de transición: establecer transiciones, duraciones, activar transiciones

Variables de entorno

• OBS_WEBSOCKET_URL : URL de WebSocket (predeterminado: ws://localhost:4455)

• OBS_WEBSOCKET_PASSWORD : Contraseña para autenticarse con OBS WebSocket (si es necesario)

Requisitos

• Node.js 16+

• OBS Studio 31+ con servidor WebSocket habilitado

• Escritorio de Claude

Licencia

Consulte el archivo LICENCIA para obtener más detalles.