Elgato MCP Server

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten (wie Claude Desktop) mit Elgato-Apps verbindet.

Übersicht

Der Elgato MCP Server fungiert als Protokollbrücke zwischen MCP-Clients und Elgato-Apps über IPC:

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

Hauptfunktionen:

• 🔌 Dynamische Tool-Erkennung — Erkennt und stellt Tools von verbundenen Elgato-Apps automatisch über MCP bereit

• 🚀 Unterstützung für zwei Transporte — stdio (für Claude Desktop) und HTTP (für Web-Clients)

• 🌐 ngrok-Integration — Optionaler öffentlicher Tunnel für den Fernzugriff

• 🔄 Automatische Wiederverbindung — Verbindet sich automatisch neu, sobald Apps verfügbar sind

• 💻 Plattformübergreifend — Unterstützt Windows und macOS

• 📢 Benachrichtigungsweiterleitung — Leitet App-Benachrichtigungen an verbundene MCP-Clients weiter

Related MCP server: Anki AI MCP Server

Installation

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

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

Ausführen ohne Installation

Sie können den Elgato MCP Server direkt ohne globale Installation mit npx ausführen:

# 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

Dies ist nützlich, um den Server ohne dauerhafte Installation auszuprobieren oder in CI/CD-Umgebungen zu verwenden.

Verwendung

stdio-Transport (Standard)

Für die Integration mit Claude Desktop oder anderen MCP-Clients über Standard-I/O:

elgato-mcp-server

HTTP-Transport

Für webbasierte Clients oder den Fernzugriff:

# 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

CLI-Optionen

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)

Protokollierung

Logs werden auf stderr mit einem Schweregrad-Label (ERROR, WARN, INFO, DEBUG) ausgegeben. Fehler und Warnungen werden immer ausgegeben; Info/Debug erfordern --verbose.

Claude-Desktop-Konfiguration

Verwenden der Desktop-Erweiterung (empfohlen)

Der einfachste Weg zur Installation ist die gepackte Desktop-Erweiterung (.mcpb), die vollständig eigenständig ist und auf der in Claude Desktop enthaltenen Node.js-Laufzeitumgebung läuft — Node.js, npm oder Internetzugang sind nicht erforderlich:

1. Laden Sie die neueste elgato_stream_deck-<version>.mcpb von der Releases-Seite herunter.

2. Öffnen Sie in Claude Desktop Einstellungen → Erweiterungen und ziehen Sie die .mcpb-Datei in das Fenster (oder doppelklicken Sie auf die Datei).

3. Stellen Sie sicher, dass die Stream-Deck-App ausgeführt wird — ihre Tools erscheinen automatisch, sobald die Verbindung hergestellt ist. Das integrierte bridge_status-Tool meldet jederzeit den Verbindungsstatus.

Alternativ können Sie den Server manuell zu Ihrer Claude-Desktop-Konfigurationsdatei hinzufügen:

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

Verwenden der globalen Installation

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

Verwenden von npx (keine Installation erforderlich)

Alternativ können Sie npx verwenden, um den Server ohne globale Installation auszuführen:

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

Hinweis: Die npx-basierte Konfiguration funktioniert mit Claude Desktop und anderen MCP-Clients, die den stdio-Transport unterstützen. Der erste Start kann einen Moment dauern, während npx das Paket herunterlädt.

HTTP-Endpunkte

Im HTTP-Modus sind die folgenden Endpunkte verfügbar:

Anforderungen

• Elgato-App mit MCP-Plugin-Unterstützung (z. B. Stream Deck)

• Node.js 18 oder höher

• Unterstützte Plattformen: Windows, macOS

Datenschutzerklärung

Dieser Server läuft vollständig auf Ihrem Rechner und kommuniziert nur mit lokal installierten Elgato-Apps über lokales IPC (Unix-Sockets auf macOS, Named Pipes auf Windows). Er erfasst, speichert oder überträgt keine personenbezogenen Daten an externe Dienste. Tool-Eingaben und -Ausgaben fließen zwischen Ihrem MCP-Client (z. B. Claude Desktop) und der verbundenen Elgato-App auf demselben Rechner; der optionale ngrok-Tunnel wird nur eingerichtet, wenn er explizit mit --ngrok aktiviert wird.

Informationen zur Datenverarbeitung von Elgato/Corsair finden Sie in der Elgato-Datenschutzerklärung.

Mitwirken

Wir freuen uns über Beiträge! Informationen zur Entwicklungsumgebung, zu Codierungsrichtlinien und zum Beitragsprozess finden Sie in CONTRIBUTING.md.

Detaillierte technische Dokumentation und Architekturinformationen finden Sie in TECHNICAL_SPECIFICATION.md.

Lizenz

MIT-Lizenz - Copyright (c) Corsair Memory Inc.

Einzelheiten finden Sie in LICENSE.

Links

• GitHub-Repository

• npm-Paket

• Issue-Tracker

• Elgato