Elgato MCP 服务器
一个模型上下文协议(MCP)服务器,将AI助手(如克洛德桌面)与Elgato apps相接.
概览
Elgato MCP 服务器作为 MCP 客户端和 Elgato apps之间的协议桥梁,通过 IPC :
MCP Client <--MCP Transport--> Bridge <--Unix Socket/Named Pipe--> Elgato App
关键特性 :
- 🔌 动态工具发现 ——通过MCP自动从连接的Elgato应用程序中发现并曝光工具
- 🚀 双重运输支助 – stdio(供克洛德桌面使用)和HTTP(供网络客户端使用)
- 🌐 ngrok 整合 ——可选公用地道实现远程接入
- 🔄 热重接 ——应用程序可用时自动重联
- 💻 横线 — 支持视窗和macOS
- 📢 转发通知 ——将应用程序通知转发给连接的MCP客户端
安装
# Global installation (recommended)
npm install -g @elgato/mcp-server
# Or with pnpm
pnpm add -g @elgato/mcp-server
不安装运行
您可以直接运行 Elgato MCP 服务器, 而无需在全球安装 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 或其他使用标准 I/O 的 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。错误和警告总是输出;信息/调试需要 --verbose。 。 。 .
Claude 桌面配置
使用桌面扩展( 建议)
最容易安装的方法是包装桌面扩展(.mcpb包括克洛德桌面(Node.js),npm或互联网访问:
- 下载最新
elgato_stream_deck-<version>.mcpb从 页 次。 。 。 . - 在 Claude 桌面中, 打开 设置- 扩展 拖动
.mcpb文件输入窗口(或双击文件). - 确保Stream Deck app正在运行——其工具在连接后自动出现. 内置
bridge_status工具随时报告连接状态.
或者,将服务器添加到您的 Claude 桌面配置文件中 :
马科斯数字 : ~/Library/Application Support/Claude/claude_desktop_config.json
窗口数字 : %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和其他支持stdio传输的MCP客户端合作. Npx下载软件包时,第一次运行可能需要时间.
HTTP 终点
在 HTTP 模式下运行时,可以使用下列端点:
| 终点 | 方法 | 说明 |
|---|---|---|
/mcp | 邮政 | MCP 请求终点 |
/mcp | 获取 | 用于流媒体的服务器-恒星事件( SSE) |
/mcp | 迪莱特 | 闭会 |
/health | 获取 | 健康检查终点 |
所需资源
- 使用 MCP 插件支持的 Elgato 应用程序( 如 Stream Deck)
- 节点.js 18或以后
- 支持的平台: Windows, macOS
隐私政策
此服务器完全运行在您的机器上, 并且仅与本地安装的 Elgato apps 通讯于本地的 IPC( macOS 上的 Unix sockets, 命名为 Windows 上的管) 。 它不收集、储存或向外部服务传送个人数据。 工具输入和输出在您的 MCP 客户端( 如 Claude Desktop) 和连接在同一机器上的 Elgato app 之间流动; 可选 ngrok 隧道只有在明确启用时才建立 --ngrok。 。 。 .
关于Elgato/Corsair的数据处理做法,见 埃尔加托隐私政策。 。 。 .
捐款
我们欢迎捐款! 关于开发设置、编码准则和贡献过程,见 捐款额。 。 。 .
详细技术文件和架构信息见 技术规格.md。 。 。 .
许可证
MIT许可证 - 版权 (c) Corsair Memory Inc.
见 自由主义 详细情况.