AI导哈

MIDI控制器配置服务器

Morningstar MIDI MCP服务器是一款通过自然语言配置Morningstar Engineering MIDI脚踏控制器的工具，支持多种设备配置和冲突检测。

  • by Turik1
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Turik1/morningstar-midi-mcp

使用说明

晨星MIDI MCP服务器

用于配置的模型上下文协议（MCP）服务器 晨星工程 使用自然语言的MIDI脚部控制器。

“我有一台MC8 Pro和一台Quad Cortex Mini。把调谐器放在左下角的长按上。”

服务器解析开关位置，从中查找正确的MIDI CC OpenMIDI 数据库，检查冲突，并通过USB对控制器进行编程。

特性

  • 通过Claude使用自然语言配置晨星控制器
  • 来自OpenMIDI的545+个设备配置文件——了解数百个踏板、放大器和合成器的MIDI实现
  • 物理布局映射——用“左下角”代替记忆开关字母
  • 冲突检测--在覆盖现有预设之前发出警告
  • 支持MC3、MC6 MKII、MC6 Pro、MC8和MC8 Pro

工具

  • 连接 --通过USB-MIDI查找并连接晨星控制器

    • port_name （字符串，可选）：MIDI端口名称。如果省略，则自动检测。

  • get_controller_info --查询控制器型号、固件版本和功能

  • get_reset --读取预设的当前状态

    • preset （字符串，必填）：开关字母（A-H）或位置(top-left, bottom-right等等）

  • set_preset_message --将MIDI消息编程到预设值上

    • preset （字符串，必填）：切换字母或位置
    • action （字符串，必填）： press, release, long_press, double_tap等等。
    • type （字符串，必填）： CC 或 PC
    • cc_number / cc_value （数字，可选）：CC参数
    • pc_number （数字，可选）：程序更改编号
    • channel （数字，必填）：MIDI通道（0-15，其中0=通道1）
    • slot （数字，可选）：消息槽0-15。如果省略，则自动分配。
    • force （布尔值，可选）：覆盖插槽中的现有消息

  • set_preset_name --重命名预设

    • preset （字符串，必填）：切换字母或位置
    • name （字符串，必填）：新名称
    • name_type （字符串，可选）： short, toggle，或 long （默认值： short)

  • get_bank_name / set_bank_name --读取或重命名当前银行

  • lookup_device --在OpenMIDI数据库中搜索设备的MIDI实现

    • device_name （字符串，必填）：设备名称（例如，“Quad Cortex”、“Timeline”、“HX Stomp”）

  • 显示消息 --在控制器的LCD上显示文本

    • text （字符串，必填）：最多20个字符
    • duration_ms （数字，可选）：显示持续时间（毫秒）（默认值：2000）

安装

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "morningstar": {
      "command": "npx",
      "args": ["-y", "morningstar-midi-mcp"]
    }
  }
}

克劳德代码

claude mcp add morningstar-midi-mcp -- npx -y morningstar-midi-mcp

从源代码构建

git clone --recurse-submodules https://github.com/Turik1/morningstar-midi-mcp.git
cd morningstar-midi-mcp
npm install
npm run build

设置

1.连接控制器

通过USB将晨星控制器连接到计算机。服务器自动检测晨星设备。

2.配置您的钻机（可选）

创建 ~/.config/morningstar-mcp/setup.yaml 要保存设备设置，请执行以下操作：

controller: MC8 Pro

devices:
  - name: Quad Cortex Mini
    midi_channel: 1
  - name: Strymon Timeline
    midi_channel: 2

没有这个文件，你可以在对话中告诉克劳德你的设置。

支持的控制器

型号 预设 布局
MC3 3 A B C
MC6 MKII 6 A B C/D E F
MC6 Pro 6 A B C/D E F
MC8 8 A B C D/E F G H
MC8 Pro 8 A B C D/E F G H

运作原理

服务器使用 SysEx协议 通过USB-MIDI。它捆绑了 OpenMIDI 数据库（由晨星工程公司维护）包含545+台设备的MIDI CC/PC映射。

由于SysEx协议无法从控制器读回预设消息，服务器在以下位置保持本地影子状态 ~/.config/morningstar-mcp/state.json 跟踪已写的内容。在此工具之外所做的更改（例如，通过晨星网络编辑器）是不可见的。

发展

npm install
npm test          # Run tests (60 tests)
npm run build     # Compile TypeScript

许可证

麻省理工学院

相关 MCP