Madrix MCP

MADRIX MCP

MCP服务器 马德里克斯 LED照明软件。通过MADRIX Remote HTTP接口公开108个工具，涵盖存储/甲板控制、层管理、提示列表、时间线、组、音频、输出、全局颜色、自动收报机/BPM和生成的层控制系列。

MADRIX远程HTTP官方文档：

• Http远程控制
• 产品文档

快速开始

git clone https://github.com/drohi-r/madrix-mcp && cd madrix-mcp
uv sync
uv run python -m madrix_mcp

确保MADRIX Remote HTTP已启用，并且可以在配置的HTTP端口上访问。

对于远程控制：

• 使用局域网或WireGuard，而不是公共互联网
• 集 MADRIX_HOST MADRIX机器
• 将该主机包含在 MADRIX_ALLOWED_HOSTS

配置

建筑

graph TD
    A["MADRIX MCP Server
madrix_mcp
108 tools · safety gate"] --> B
    B["HTTP Remote Client
GET/SET commands"] --> C
    C["MADRIX
Remote HTTP on port 80"]

    D["Safety Profiles
lab · show-safe · read-only"] -.-> A
    E["Layer Control
Generated tool families
index + current-layer variants"] -.-> A

    style A fill:#1a1a2e,stroke:#00E0A4,color:#fff
    style B fill:#1a1a2e,stroke:#00E0A4,color:#fff
    style C fill:#1a1a2e,stroke:#0f3460,color:#fff
    style D fill:#0f3460,stroke:#0f3460,color:#fff
    style E fill:#0f3460,stroke:#0f3460,color:#fff

安全简介

• 实验室 --已启用读/写，无需额外的破坏性确认
• 显示安全 --启用读/写，需要进行破坏性操作 confirm=true
• 只读 --阻止所有写入操作，保留健康/配置/读取工具可用

工具

运输和安全

身份和全球状态

播放和状态读取

淡入淡出和主控

储存和甲板控制

线索列表控制

音频和输出控制

群控

时间线控制

全局颜色控制

甲板存放位置控制

Ticker和BPM控制

图层控制（生成的族）

每个族都提供基于索引的图层变体和当前图层变体：

克劳德桌面版

{
  "mcpServers": {
    "madrix": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/madrix-mcp", "python", "-m", "madrix_mcp"],
      "env": {
        "MADRIX_HOST": "127.0.0.1",
        "MADRIX_HTTP_PORT": "80",
        "MADRIX_SAFETY_PROFILE": "show-safe"
      }
    }
  }
}

VS代码/光标

{
  "servers": {
    "madrix": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/madrix-mcp", "python", "-m", "madrix_mcp"],
      "env": {
        "MADRIX_HOST": "127.0.0.1",
        "MADRIX_HTTP_PORT": "80",
        "MADRIX_SAFETY_PROFILE": "show-safe"
      }
    }
  }
}

法典

创建一个 codex.json MCP配置文件：

{
  "mcpServers": {
    "madrix": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/madrix-mcp", "python", "-m", "madrix_mcp"],
      "env": {
        "MADRIX_HOST": "127.0.0.1",
        "MADRIX_HTTP_PORT": "80",
        "MADRIX_SAFETY_PROFILE": "show-safe"
      }
    }
  }
}

然后使用以下命令运行Codex：

codex --mcp-config codex.json

安全生产

此服务器专为现场表演环境而设计，意外写入可能会中断正在运行的LED安装。

• 主机分配 --只有 127.0.0.1, localhost，以及 ::1 默认情况下是允许的。通过以下方式显式添加LAN主机 MADRIX_ALLOWED_HOSTS.Set * 允许任何主机。
• 只读模式 --set MADRIX_READ_ONLY=1 以阻止所有写入操作。运行状况、配置和读取工具仍然可用。
• 确认破坏性浇口 --set MADRIX_CONFIRM_DESTRUCTIVE=1 要求 confirm=true 关于破坏性行动，包括 SetBlackout, SetMaster、存储甲板开关和提示列表播放更改。
• 安全简介 — MADRIX_SAFETY_PROFILE 给你一个理智的起点： lab （全开）， show-safe （破坏性确认），或 read-only （没有写）。
• 原始逃生舱口 — get_remote 和 set_remote 允许任何MADRIX远程HTTP功能，但仍由相同的安全模型控制。
• 输入验证 --所有工具在进行任何HTTP调用之前都会验证参数。无效输入返回结构化JSON错误，从不返回原始异常。
• 错误隔离 --所有工具都包含在错误处理程序中。网络故障、验证失败和意外异常返回 {"ok": false, "error": "..."} 而不是使MCP会话崩溃。

实时验证

针对真实的MADRIX实例进行了验证 192.168.20.179:80:

• health_check, get_product, get_cuelist_summary, get_storage_state
• get_audio_state, get_output_state, get_timeline_summary, get_group_summary
• get_storage_place_details, set_master, set_fade_value
• 通过生成组写入路径 SetGroupValue

发展

uv sync
uv run python -m pytest -v   # 67 tests

许可证

Apache 2.0