Elgato MCP Server

Сервер Model Context Protocol (MCP), который связывает ИИ-ассистентов (например, Claude Desktop) с приложениями Elgato.

Обзор

Elgato MCP Server действует как протокольный мост между MCP-клиентами и приложениями Elgato через IPC:

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

Ключевые возможности:

• 🔌 Динамическое обнаружение инструментов — автоматически обнаруживает и предоставляет инструменты подключенных приложений Elgato через MCP

• 🚀 Поддержка двух транспортов — stdio (для Claude Desktop) и HTTP (для веб-клиентов)

• 🌐 Интеграция с ngrok — опциональный публичный туннель для удаленного доступа

• 🔄 Горячее переподключение — автоматически переподключается, когда приложения становятся доступными

• 💻 Кроссплатформенность — поддерживает Windows и macOS

• 📢 Пересылка уведомлений — пересылает уведомления приложений подключенным MCP-клиентам

Related MCP server: Anki AI MCP Server

Установка

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

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

Запуск без установки

Вы можете запустить Elgato MCP Server напрямую, без глобальной установки, с помощью 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

Это полезно для ознакомления с сервером без постоянной установки или для использования в средах CI/CD.

Использование

Транспорт stdio (по умолчанию)

Для интеграции с Claude Desktop или другими MCP-клиентами, использующими стандартный ввод-вывод:

elgato-mcp-server

Транспорт HTTP

Для веб-клиентов или удаленного доступа:

# 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

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)

Логирование

Журналы записываются в stderr с меткой уровня серьезности (ERROR, WARN, INFO, DEBUG). Ошибки и предупреждения выводятся всегда; info/debug требуют --verbose.

Настройка Claude Desktop

Использование настольного расширения (рекомендуется)

Самый простой способ установки — упакованное настольное расширение (.mcpb), которое полностью автономно и работает в среде выполнения Node.js, входящей в состав Claude Desktop — не требуется ни Node.js, ни npm, ни доступ в интернет:

1. Загрузите последний elgato_stream_deck-<version>.mcpb со страницы релизов.

2. В Claude Desktop откройте Настройки → Расширения и перетащите файл .mcpb в окно (или дважды щелкните по файлу).

3. Убедитесь, что приложение Stream Deck запущено — его инструменты появятся автоматически после подключения. Встроенный инструмент bridge_status сообщает состояние подключения в любой момент.

В качестве альтернативы вы можете добавить сервер в файл конфигурации Claude Desktop вручную:

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

Использование глобальной установки

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

Использование npx (без установки)

В качестве альтернативы вы можете использовать npx для запуска сервера без глобальной установки:

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

Примечание: Конфигурация на основе npx работает с Claude Desktop и другими MCP-клиентами, поддерживающими транспорт stdio. Первый запуск может занять некоторое время, пока npx загружает пакет.

HTTP-эндпоинты

При работе в режиме HTTP доступны следующие эндпоинты:

Требования

• Приложение Elgato с поддержкой MCP-плагинов (например, Stream Deck)

• Node.js 18 или новее

• Поддерживаемые платформы: Windows, macOS

Политика конфиденциальности

Этот сервер полностью работает на вашем компьютере и взаимодействует только с локально установленными приложениями Elgato через локальный IPC (Unix-сокеты на macOS, именованные каналы на Windows). Он не собирает, не хранит и не передает персональные данные внешним сервисам. Входные и выходные данные инструментов передаются между вашим MCP-клиентом (например, Claude Desktop) и подключенным приложением Elgato на том же компьютере; опциональный туннель ngrok устанавливается только при явном включении с помощью --ngrok.

О методах обработки данных Elgato/Corsair см. в Политике конфиденциальности Elgato.

Участие в разработке

Мы приветствуем вклад! Информацию о настройке среды разработки, правилах написания кода и процессе внесения вклада см. в CONTRIBUTING.md.

Подробную техническую документацию и информацию об архитектуре см. в TECHNICAL_SPECIFICATION.md.

Лицензия

Лицензия MIT - Copyright (c) Corsair Memory Inc.

Подробности см. в LICENSE.

Ссылки

• Репозиторий GitHub

• npm-пакет

• Трекер задач

• Elgato