AI导哈

流控制台管理协议

一个让Claude交互式管理Elgato Stream Deck按钮、Elgato Key Lights和Philips Hue灯光的MCP服务器。

  • by sohumsuthar
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 sohumsuthar/stream-deck-mcp

使用说明

溪流甲板mcp

MCP（模型上下文协议）服务器，允许Claude交互式管理您的Elgato Stream Deck按钮、Elgato按键灯和飞利浦秀灯。

特性

流甲板剖面管理（10个工具）

  • streamdeck_list_profiles --列出所有已配置的配置文件
  • streamdeck_getlayout --查看每个按钮上的内容（操作、标题、设置）
  • streamdeck_add_hotkey --为按钮指定键盘快捷键
  • streamdeck_add_网站 --指定一个URL，以便在按下按钮时打开
  • streamdeck_add_app --将应用启动器分配给按钮
  • streamdeck_add_text --为按钮指定文本粘贴操作
  • streamdeck_add_多媒体 --添加媒体控件（播放/暂停、下一步、音量、静音）
  • streamdeck_move_action --从按钮中删除操作
  • streamdeck_settle --更改按钮的显示标题和颜色
  • streamdeck_load --重新启动Stream Deck软件以应用更改

Elgato按键灯控制（4个工具）

  • keylight_discover --通过mDNS发现网络上的关键灯
  • keylight_get_status --获取灯光状态（开/关、亮度、色温）
  • keylight_set --设置灯光属性（开/关、亮度、温度）
  • 键盘记录 --打开/关闭灯光

飞利浦色调控制（6个工具）

  • hue_discover_bridge --在您的网络上查找Hue网桥
  • hue_air --与桥配对（先按按钮！）
  • 色调列表灯 --列出所有当前状态的灯
  • 色调_亮度 --控制单个灯（开/关、亮度、颜色、温度）
  • hue_list_group --列出房间/团体
  • hue_set组 --控制一组灯光

先决条件

  • Node.js 20+
  • 已安装Elgato Stream Deck软件（用于Stream Deck剖面工具）
  • 同一网络上的Elgato按键灯（用于按键灯工具）
  • 同一网络上的飞利浦Hue桥接器（用于Hue工具）

安装

git clone https://github.com/sohumsuthar/stream-deck-mcp.git
cd stream-deck-mcp
npm install
npm run build

使用Claude Desktop

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "stream-deck": {
      "command": "node",
      "args": ["/absolute/path/to/stream-deck-mcp/build/index.js"]
    }
  }
}

然后重新启动Claude Desktop。你可以问克劳德这样的问题：

  • “让我看看我的流甲板上现在有什么”
  • “在按钮[0,2]上为Ctrl+Shift+M添加一个热键”
  • “在右上角按钮上添加GitHub的网站快捷方式”
  • “添加播放/暂停按钮和音量静音按钮”
  • “删除按钮[1,0]上的操作”
  • “发现我的关键灯并将其设置为50%的亮度”
  • “把客厅里的灯都关掉”

使用Claude代码

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "stream-deck": {
      "command": "node",
      "args": ["/absolute/path/to/stream-deck-mcp/build/index.js"]
    }
  }
}

运作原理

Stream Deck工具读取和写入Elgato Stream Deck软件使用的配置文件（存储在 %APPDATA%\Elgato\StreamDeck\ProfilesV2\).更改后，使用 streamdeck_reload 重新启动Stream Deck软件并应用它们。

按钮坐标

按钮由以下方式寻址 [row, col] 从...开始 [0,0] 在左上角：

[0,0] [0,1] [0,2] [0,3] [0,4]
[1,0] [1,1] [1,2] [1,3] [1,4]
[2,0] [2,1] [2,2] [2,3] [2,4]

飞利浦色调设置

首次设置：

  1. 呼叫 hue_discover_bridge 找到你的桥
  2. 按下Hue桥接器上的物理按钮
  3. 呼叫 hue_pair 在30秒内使用网桥IP

凭据保存到 ~/.stream-deck-mcp/hue-config.json 所以你只需要配对一次。

发展

npm run dev    # Run with tsx (hot reload)
npm run build  # Compile TypeScript
npm start      # Run compiled version

许可证

麻省理工学院

相关 MCP