🚀 Teenage Engineering EP-133 K.O. II 的 MCP 接口
本项目是一个模型上下文协议（MCP）服务器，可通过 MIDI 控制 Teenage Engineering 的 EP-133 K.O. II 采样器，为音乐创作和控制带来便利。
🚀 快速开始
本项目是一个模型上下文协议（MCP）服务器，主要用于通过 MIDI 控制 Teenage Engineering 的 EP-133 K.O. II 采样器。借助该服务器，用户可以利用文本命令对设备进行各种操作。
✨ 主要特性
- 通过 MIDI 连接到您的 EP-133 K.O. II 设备。
- 支持使用文本命令播放音符和模式。
- 可查看默认垫配置，了解声音映射。
- 能使用简单的基于文本的语法创建并播放鼓点模式。
- 支持多种乐器参考方法，如垫标签、MIDI 音高、乐器名称、声音名称。
- 可同时播放多个乐器的鼓点模式。
- 与 Claude 通过 MCP 集成。
📦 安装指南
先决条件
- Python 3.8 或更高版本。
mido（用于 MIDI 处理）。mcp（模型上下文协议 SDK）。
快速安装
# 安装所需的包
pip install mido "mcp[cli]"
# 克隆仓库
git clone https://github.com/benjaminr/mcp-koii.git
cd mcp-koii
# 安装MCP服务器
mcp install koii_server.py:server -e .
💻 使用示例
与 Claude Desktop 一起使用
- 确保您的 EP-133 K.O. II 通过 USB 连接到计算机。
- 使用支持 MCP 的 Claude Desktop 启动。
- 通过向 Claude 提出自然语言问题来控制您的 EP-133 K.O. II：
- "列出可用的 MIDI 端口"
- "连接到 EP-133 设备"
- "播放 C 大调音阶"
- "播放鼓点模式，贝斯在节拍 1 和 3，军鼓在 2 和 4，踩镲在每八分音符"
开发模式下运行
您可以在开发模式下运行 MCP 服务器以进行测试，而无需 Claude Desktop：
# 带有检查器 UI 运行
mcp dev koii_server.py:server -e .
📚 详细文档
功能和命令
基本命令
- 列出可用的 MIDI 端口：显示系统上所有可用的 MIDI 输出端口。
- 连接到 MIDI 设备：通过名称或端口号连接到 EP-133 K.O. II。
- 断开连接：从当前连接的 EP-133 K.O. II 断开。
音乐播放
- 设置 BPM：使用指定的节拍数设置播放速度。
- 播放音阶：按顺序播放给定的 MIDI 音高列表。
- 播放模式：以循环方式播放鼓点模式。
⚠️ 注意事项
⚠️ 重要提示
确保 EP-133 K.O. II 处于正确的 MIDI 模式。使用准确的声音名称、垫标签、MIDI 音高或声音名称进行未知乐器测试。
📄 许可证
该项目在 MIT 许可证下，有关详细信息请参阅 LICENSE 文件。
👏 致谢
- Teenage Engineering 提供 EP-133 K.O. II。
- Anthropic 为 Claude 和模型上下文协议。
- MIDO 用于 MIDI 处理库。