MCP Koii

This is a MIDI controller project that controls the Teenage Engineering EP-133 K.O. II sampler through the MCP protocol. It supports playing notes, rhythm patterns, and drum patterns using text commands, and can be integrated with Claude to achieve natural language control.

Entertainment and media Education and learning tools #MIDI control #Music production #Text interaction #Hardware integration .Python

rating : 2 points

downloads : 13

update time : 2025-04-28

What is the EP-133 K.O. II MCP Controller?

This is an intelligent interface that controls the EP-133 K.O. II music device through natural language interaction with Claude AI. You can describe your musical ideas in everyday language, and the system will automatically convert them into MIDI instructions and send them to the device.

How to use this controller?

Simply connect the device to your computer and enter musical instructions in the Claude chat interface. For example, 'Play a C major scale' or 'Create a 1-3-5 drum rhythm'.

Applicable scenarios

Suitable for quick inspiration testing during music creation, on - site performance control, music teaching demonstrations, and remote control scenarios when it is inconvenient to directly operate the device.

Main features

Intelligent device connectionAutomatically identify connected EP-133 devices and support multi - device switching

Natural language controlDescribe your musical ideas in everyday English, and they will be automatically converted into professional MIDI instructions

Intelligent drum kit programmingSupports four ways of sound reference and rich rhythm syntax, and can create complex rhythm patterns

Sound browserBrowse the device's preset sound library and find the desired sounds by category

Advantages and limitations

Advantages

No need to learn complex MIDI protocols, and you can create music using natural language

Support simultaneous control of multiple sound voices

Provide intelligent retrieval function for the device's sound library

Seamlessly cooperate with other creative functions of Claude AI

Limitations

Requires USB connection to a physical device

Complex rhythms may require adjusting BPM parameters

Some advanced MIDI functions still need to be implemented by professional DAWs

How to use

Install software

Ensure that Python 3.8+ is installed, and then install the required dependencies via pip

Connect the device

Connect the EP-133 K.O. II to your computer using a USB cable and turn on the device's power

Start the service

Run the MCP server in the project directory. It is recommended to use the development mode for easy debugging

Start creating

Enter musical instructions in the Claude chat window, such as 'Create a drum rhythm with syncopation'

Usage examples

Basic scale practiceQuickly test the device's scales and sounds

Drum kit creationCreate complex multi - voice drum rhythms

Sound explorationDiscover the special sound effects built into the device

Frequently asked questions

Why isn't the device responding?

How to reference a specific drum sound?

How many notes can be played simultaneously?

Related resources

Official EP-133 documentation

Official device manual and MIDI implementation chart

MCP protocol description

Technical specification of the Model Context Protocol

GitHub repository

Project source code and issue tracking

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

This project is a Model Context Protocol (MCP) server designed to control the Teenage Engineering EP-133 K.O. II sampler via MIDI.

🚀 Quick Start

The MCP server in this project enables users to control the Teenage Engineering EP-133 K.O. II sampler through MIDI, offering a convenient way to play music and create drum patterns.

✨ Features

Connect to your EP-133 K.O. II device via MIDI.
Play notes and patterns using text commands.
View the default pad configuration to understand sound mappings.
Create and play drum patterns using a simple text-based syntax.
Support multiple instrument reference methods (pad labels, MIDI pitches, instrument names, sound names).
Play drum patterns of multiple instruments simultaneously.
Integrate with Claude via MCP.

📦 Installation

Prerequisites

Python 3.8 or higher.
mido (for MIDI processing).
mcp (Model Context Protocol SDK).

Quick Installation

# 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 .

💻 Usage Examples

Using with Claude Desktop

Ensure your EP-133 K.O. II is connected to your computer via USB.
Launch Claude Desktop with MCP support.
Control your EP-133 K.O. II by asking natural language questions to Claude:
- "List available MIDI ports."
- "Connect to the EP-133 device."
- "Play a C major scale."
- "Play a drum pattern with bass on beats 1 and 3, snare on 2 and 4, and hi-hat on every eighth note."

Running in Development Mode

You can run the MCP server in development mode for testing without Claude Desktop:

# Run with the inspector UI
mcp dev koii_server.py:server -e .

📚 Documentation

Basic Commands

List available MIDI ports: Display all available MIDI output ports on the system.
Connect to a MIDI device: Connect to the EP-133 K.O. II by name or port number.
Disconnect: Disconnect from the currently connected EP-133 K.O. II.

Music Playback

Set BPM: Set the playback speed using the specified number of beats per minute.
Play a scale: Play a given list of MIDI pitches in sequence.
Play a pattern: Play a drum pattern in a loop.

📄 License

This project is under the MIT License. For more details, please refer to the LICENSE file.

⚠️ Important Note

Ensure that the EP-133 K.O. II is in the correct MIDI mode. Use accurate sound names, pad labels, MIDI pitches, or sound names for testing unknown instruments.