使用说明
EP-133 K.O.II青少年工程MCP接口
该项目是一个模型上下文协议（MCP）服务器，通过MIDI充当青少年工程EP-133 K.O.II采样器的控制器
特性
- 通过MIDI连接到EP-133 K.O.II设备
- 通过文本命令播放音符和图案
- 查看默认键盘配置以了解声音映射
- 使用简单的基于文本的语法创建和播放鼓图案
- 支持多种乐器参考方法（键盘标签、MIDI音符、乐器名称、声音名称）
- 以鼓模式同时播放多种乐器
- 通过MCP与Claude集成
安装
先决条件
- Python 3.8或更高版本
mido（MIDI处理）mcp（模型上下文协议SDK）
快速安装
# Install the required packages
pip install mido "mcp[cli]"
# Clone the repository
git clone https://github.com/benjaminr/mcp-koii.git
cd mcp-koii
# Install the MCP server
mcp install koii_server.py:server -e .
使用Claude Desktop
-
确保EP-133 K.O.II已通过USB连接到计算机。
-
启动启用MCP的Claude Desktop。
-
通过问克劳德自然语言问题开始控制EP-133 K.O.II，例如：
- “列出可用的MIDI端口”
- “连接到EP-133设备”
- “演奏C大调音阶”
- 演奏一种鼓模式，在节拍1和3上踢，在节拍2和4上下圈套，每8个音符上放一个高帽
以开发模式运行
您可以在开发模式下运行MCP服务器，在没有Claude Desktop的情况下对其进行测试：
# Run with the inspector UI
mcp dev koii_server.py:server -e .
功能和命令
基本命令
- 列出可用的MIDI端口：显示系统上所有可用的MIDI输出端口。
- 连接到MIDI设备：按名称或端口号连接EP-133 K.O.II。
- 断开：关闭与当前MIDI设备的连接。
演奏笔记和模式
- 播放一个音符：以指定的速度和持续时间演奏一个音符。
- 播放模式：播放带有计时信息的音符序列。
- 播放鼓图案：播放基于文本的鼓模式。
声音浏览器
- 列出声音类别：查看可用的声音类别（踢腿、Snares等）。
- 按类别列出声音：浏览特定类别中的声音。
- 获取默认焊盘配置：查看默认情况下哪些声音映射到每个键盘。
MIDI实现
EP-133 K.O.II对以下MIDI消息作出响应：
- 注释打开/关闭：触发键盘上的声音（C2-B5，音符36-83）
鼓图案语法
鼓型系统支持四种不同的声音参考方式：
1.使用焊盘参考：
x...x...x...x... # A.
....x.......x... # A2
x.x.x.x.x.x.x.x. # A5
2.使用MIDI音符编号：
x...x...x...x... # 36
....x.......x... # 40
x.x.x.x.x.x.x.x. # 43
3.使用声音名称：
x...x...x...x... # "MICRO KICK"
....x.......x... # "NT SNARE"
x.x.x.x.x.x.x.x. # "NT HH CLOSED"
4.混合参考文献：
x...x...x...x... # A. (pad reference)
....x.......x... # 40 (MIDI note)
......x......... # "NT RIDE" (sound name)
花样格式
- 每条线代表一种不同的乐器/声音
- “x”或“x”表示命中（高速）
- “o”或“o”表示撞击较轻（速度较低）
- '.'表示未命中
- 每个位置代表第16个音符
- “#”后的注释指定使用任何参考方法触发的声音
- 多个仪器可以同时触发，其命中重叠
故障排除
- 未找到MIDI端口：确保EP-133 K.O.II已连接并通电。
- 连接问题：尝试重新连接USB电缆或重新启动EP-133。
- 音符未播放：验证设备是否处于正确的MIDI模式。
- 多种乐器不能同时演奏：使用更高的BPM值，以确保EP-133 K.O.II在播放过程中可以处理所有音符。
- 未知仪器：使用精确的乐器名称、键盘标签、MIDI音符或引号中的声音名称。
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。