MCP Koii

🚀 Teenage Engineering EP-133 K.O. II 的 MCP 接口

本项目是一个模型上下文协议（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 音高列表。
• 播放模式：以循环方式播放鼓点模式。

📄 许可证

该项目在 MIT 许可证下发布，有关详细信息请参阅 LICENSE 文件。

致谢

• Teenage Engineering 提供了 EP-133 K.O. II。
• Anthropic 为 Claude 和模型上下文协议做出了贡献。
• MIDO 提供了 MIDI 处理库。

⚠️ 重要提示

请确保 EP-133 K.O. II 处于正确的 MIDI 模式。在进行未知乐器测试时，请使用准确的声音名称、垫标签、MIDI 音高或声音名称。