Elgato MCP Server

Un servidor de Model Context Protocol (MCP) que conecta asistentes de IA (como Claude Desktop) con las aplicaciones de Elgato.

Descripción general

El servidor Elgato MCP actúa como puente de protocolo entre los clientes MCP y las aplicaciones de Elgato a través de IPC:

MCP Client <--MCP Transport--> Bridge <--Unix Socket/Named Pipe--> Elgato App

Características principales:

• 🔌 Descubrimiento dinámico de herramientas — Descubre y expone automáticamente las herramientas de las aplicaciones de Elgato conectadas a través de MCP

• 🚀 Compatibilidad con doble transporte — stdio (para Claude Desktop) y HTTP (para clientes web)

• 🌐 Integración con ngrok — Túnel público opcional para acceso remoto

• 🔄 Reconexión en caliente — Se reconecta automáticamente cuando las aplicaciones están disponibles

• 💻 Multiplataforma — Compatible con Windows y macOS

• 📢 Reenvío de notificaciones — Reenvía las notificaciones de las aplicaciones a los clientes MCP conectados

Related MCP server: Anki AI MCP Server

Instalación

# Global installation (recommended)
npm install -g @elgato/mcp-server

# Or with pnpm
pnpm add -g @elgato/mcp-server

Ejecución sin instalación

Puedes ejecutar el servidor Elgato MCP directamente sin instalarlo globalmente usando npx:

# Run with stdio transport (default)
npx -y @elgato/mcp-server@latest

# Run with HTTP transport
npx -y @elgato/mcp-server@latest --http

# Run with HTTP transport on a custom port
npx -y @elgato/mcp-server@latest --http --port 3000

# Run with ngrok tunnel
NGROK_AUTHTOKEN=your_token npx -y @elgato/mcp-server@latest --http --ngrok

# Run with verbose logging
npx -y @elgato/mcp-server@latest --verbose

Esto es útil para probar el servidor sin una instalación permanente, o para usarlo en entornos de CI/CD.

Uso

Transporte stdio (predeterminado)

Para la integración con Claude Desktop u otros clientes MCP que usen E/S estándar:

elgato-mcp-server

Transporte HTTP

Para clientes web o acceso remoto:

# Start HTTP server on default port (9090)
elgato-mcp-server --http

# Custom port
elgato-mcp-server --http --port 3000

# With ngrok tunnel (requires NGROK_AUTHTOKEN env var)
NGROK_AUTHTOKEN=your_token elgato-mcp-server --http --ngrok

Opciones de CLI

Options:
  --transport <mode>  Transport mode: 'stdio' (default) or 'http'
  --http              Shorthand for --transport http
  --port <number>     HTTP server port (default: 9090)
  --ngrok             Enable ngrok tunnel (requires NGROK_AUTHTOKEN env var)
  --help, -h          Show help message
  --verbose, -v       Enable verbose logging (default: silent)

Registro

Los registros se escriben en stderr con una etiqueta de severidad (ERROR, WARN, INFO, DEBUG). Los errores y las advertencias siempre se muestran; info/debug requieren --verbose.

Configuración de Claude Desktop

Uso de la extensión de escritorio (recomendado)

La forma más sencilla de instalarlo es mediante la extensión de escritorio empaquetada (.mcpb), que es totalmente autónoma y se ejecuta en el entorno de ejecución de Node.js incluido con Claude Desktop — no se requieren Node.js, npm ni acceso a internet:

1. Descarga la versión más reciente de elgato_stream_deck-<version>.mcpb desde la página de versiones.

2. En Claude Desktop, abre Configuración → Extensiones y arrastra el archivo .mcpb a la ventana (o haz doble clic en el archivo).

3. Asegúrate de que la aplicación Stream Deck esté en ejecución — sus herramientas aparecen automáticamente una vez conectada. La herramienta integrada bridge_status informa del estado de la conexión en cualquier momento.

Alternativamente, añade el servidor a tu archivo de configuración de Claude Desktop manualmente:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Uso de la instalación global

{
    "mcpServers": {
        "elgato": {
            "command": "elgato-mcp-server"
        }
    }
}

Uso de npx (sin necesidad de instalación)

Alternativamente, puedes usar npx para ejecutar el servidor sin instalarlo globalmente:

{
    "mcpServers": {
        "elgato": {
            "command": "npx",
            "args": ["--yes", "@elgato/mcp-server@latest"]
        }
    }
}

Nota: La configuración basada en npx funciona con Claude Desktop y otros clientes MCP compatibles con el transporte stdio. La primera ejecución puede tardar un momento mientras npx descarga el paquete.

Endpoints HTTP

Cuando se ejecuta en modo HTTP, los siguientes endpoints están disponibles:

Requisitos

• Aplicación de Elgato compatible con plugins MCP (p. ej., Stream Deck)

• Node.js 18 o posterior

• Plataformas compatibles: Windows, macOS

Política de privacidad

Este servidor se ejecuta íntegramente en tu máquina y solo se comunica con las aplicaciones de Elgato instaladas localmente a través de IPC local (sockets Unix en macOS, named pipes en Windows). No recopila, almacena ni transmite datos personales a servicios externos. Las entradas y salidas de las herramientas fluyen entre tu cliente MCP (p. ej., Claude Desktop) y la aplicación de Elgato conectada en la misma máquina; el túnel opcional de ngrok solo se establece cuando se habilita explícitamente con --ngrok.

Para conocer las prácticas de tratamiento de datos de Elgato/Corsair, consulta la Política de privacidad de Elgato.

Contribuciones

¡Damos la bienvenida a las contribuciones! Para la configuración del entorno de desarrollo, las pautas de codificación y el proceso de contribución, consulta CONTRIBUTING.md.

Para documentación técnica detallada e información sobre la arquitectura, consulta TECHNICAL_SPECIFICATION.md.

Licencia

Licencia MIT - Copyright (c) Corsair Memory Inc.

Consulta LICENSE para más detalles.

Enlaces

• Repositorio de GitHub

• Paquete npm

• Seguimiento de incidencias

• Elgato