KoiiSAFE

This project is a Model Context Protocol (MCP) server that acts as a controller for the Teenage Engineering EP-133 K.O. II sampler via MIDI

Features

• Connect to your EP-133 K.O. II device via MIDI
• Play notes and patterns through text commands
• View the default pad configuration to understand sound mapping
• Create and play drum patterns with a simple text-based syntax
• Support for multiple instrument reference methods (pad labels, MIDI notes, instrument names, sound names)
• Simultaneous playback of multiple instruments in drum patterns
• Integration with Claude through MCP

Installation

Prerequisites

• Python 3.8 or later
• mido (MIDI handling)
• mcp (Model Context Protocol SDK)

Quick Install

# 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 with Claude Desktop

1. Make sure your EP-133 K.O. II is connected to your computer via USB.

1. Launch Claude Desktop with MCP enabled.

1. Start controlling your EP-133 K.O. II by asking Claude natural language questions like:
2. "List available MIDI ports"
3. "Connect to the EP-133 device"
4. "Play a C major scale"
5. "Play a drum pattern with kick on beats 1 and 3, snare on 2 and 4, and hi-hat on every 8th note"

Running in Development Mode

You can run the MCP server in development mode to test it without Claude Desktop:

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

Features and Commands

Basic Commands

• List available MIDI ports: Shows all available MIDI output ports on your system.
• Connect to a MIDI device: Connect to the EP-133 K.O. II by name or port number.
• Disconnect: Close the connection to the current MIDI device.

#