MCP Koii

🚀 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 一起使用

1. 确保您的 EP-133 K.O. II 通过 USB 连接到计算机。
2. 使用支持 MCP 的 Claude Desktop 启动。
3. 通过向 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 处理库。