Elgato MCP Server

AIアシスタント（Claude Desktopなど）とElgatoアプリを橋渡しするModel Context Protocol（MCP）サーバーです。

概要

Elgato MCP Serverは、IPCを介してMCPクライアントとElgatoアプリ間のプロトコルブリッジとして機能します：

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

主な機能：

• 🔌 動的ツール検出 — 接続されたElgatoアプリからツールをMCP経由で自動的に検出して公開します

• 🚀 デュアルトランスポート対応 — stdio（Claude Desktop用）とHTTP（Webクライアント用）

• 🌐 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

インストールなしで実行する

npxを使用すると、Elgato MCP Serverをグローバルにインストールせずに直接実行できます：

# 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トランスポート（デフォルト）

標準I/Oを使用するClaude Desktopやその他のMCPクライアントとの統合用：

elgato-mcp-server

HTTPトランスポート

Webベースのクライアントやリモートアクセス用：

# 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)

ロギング

ログは重大度ラベル（ERROR、WARN、INFO、DEBUG）付きでstderrに書き込まれます。エラーと警告は常に出力されます。info/debugは--verboseが必要です。

Claude Desktopの設定

デスクトップ拡張機能を使用する（推奨）

最も簡単なインストール方法は、パッケージ化されたデスクトップ拡張機能（.mcpb）を使用することです。これは完全に自己完結型で、Claude Desktopに同梱されているNode.jsランタイム上で動作するため、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ベースの設定は、stdioトランスポートをサポートするClaude Desktopやその他のMCPクライアントで動作します。初回実行時は、npxがパッケージをダウンロードするため少し時間がかかる場合があります。

HTTPエンドポイント

HTTPモードで実行する場合、次のエンドポイントが利用可能です：

要件

• MCPプラグイン対応のElgatoアプリ（例：Stream Deck）

• Node.js 18以降

• 対応プラットフォーム：Windows、macOS

プライバシーポリシー

このサーバーは完全にお使いのマシン上で動作し、ローカルIPC（macOSではUnixソケット、Windowsでは名前付きパイプ）を介してローカルにインストールされたElgatoアプリとのみ通信します。個人データを外部サービスに収集、保存、送信することはありません。ツールの入力と出力は、同じマシン上のMCPクライアント（例：Claude Desktop）と接続されたElgatoアプリの間を流れます。オプションのngrokトンネルは、--ngrokで明示的に有効にした場合にのみ確立されます。

Elgato/Corsairのデータ取り扱い慣行については、Elgatoプライバシーポリシーを参照してください。

コントリビューション

コントリビューションを歓迎します！開発環境のセットアップ、コーディングガイドライン、コントリビューションのプロセスについては、CONTRIBUTING.mdを参照してください。

詳細な技術ドキュメントとアーキテクチャ情報については、TECHNICAL_SPECIFICATION.mdを参照してください。

ライセンス

MITライセンス - Copyright (c) Corsair Memory Inc.

詳細については、LICENSEを参照してください。

リンク

• GitHubリポジトリ

• npmパッケージ

• Issueトラッカー

• Elgato