MCP Interface for Teenage Engineering EP-133 K.O. II

MCP Interface for Teenage Engineering EP-133 K.O. II

site icon
2025.04.15 0
Python音乐控制MIDI 服务娱乐功能
mcp-koii 是一个基于 Model Context Protocol (MCP) 的服务,专门用于通过 MIDI 控制 Teenage Engineering EP-133 K.O. II 采样器。它允许用户通过文本命令播放音符和鼓点模式,支持多种乐器参考方法,并能与 Claude 集成,实现自然语言控制。
View on GitHub

Overview

基本能力

产品定位

mcp-koii 是一个 MIDI 控制器服务,专门用于控制 Teenage Engineering EP-133 K.O. II 采样器。

核心功能

  • 通过 MIDI 连接 EP-133 K.O. II 设备
  • 通过文本命令播放音符和模式
  • 查看默认的 pad 配置以理解声音映射
  • 使用简单的基于文本的语法创建和播放鼓点模式
  • 支持多种乐器参考方法(pad 标签、MIDI 音符、乐器名称、声音名称)
  • 在鼓点模式中同时播放多个乐器
  • 通过 MCP 与 Claude 集成

适用场景

  • 音乐制作和采样
  • 现场表演控制
  • 音乐教育和学习

工具列表

  • mido:用于 MIDI 处理的库
  • mcp:Model Context Protocol SDK

常见问题解答

  • 没有找到 MIDI 端口:确保 EP-133 K.O. II 已连接并开机。
  • 连接问题:尝试重新连接 USB 线或重启 EP-133。
  • 音符不播放:确认设备处于正确的 MIDI 模式。
  • 多个乐器不能同时播放:使用更高的 BPM 值以确保 EP-133 K.O. II 能在播放过程中处理所有音符。
  • 未知乐器:使用确切的乐器名称、pad 标签、MIDI 音符或带引号的声音名称。

使用教程

使用依赖

安装前置依赖:

pip install mido "mcp[cli]"

安装教程

  1. 克隆仓库:
git clone https://github.com/benjaminr/mcp-koii.git
cd mcp-koii
  1. 安装 MCP 服务:
mcp install koii_server.py:server -e .

调试方式

运行开发模式以测试服务:

mcp dev koii_server.py:server -e .

标签信息

  • 安装类型:stdio
  • 产品定位:音乐控制, MIDI 服务

许可证

该项目遵循 MIT 开源许可条款。