mcp-koii

Overview

This MCP server enables interaction with the Teenage Engineering EP-133 K.O. II sampler through MIDI commands. It provides functionality for playing individual notes, creating drum patterns with a text-based syntax, and browsing available sounds. The server supports multiple ways to reference instruments (pad labels, MIDI notes, instrument names, sound names) and allows simultaneous playback of multiple instruments. Integration with Claude Desktop allows for natural language control of the device.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_midi_ports

  List available MIDI ports on your system

  Try:List available MIDI portsTry:Show me MIDI devices connected to my computer
• connect_midi_device

  Connect to a MIDI device by name or port number

  Try:Connect to the EP-133 deviceTry:Connect to MIDI port 1Try:Connect to my KO-II sampler
• disconnect_midi_device

  Close the connection to the current MIDI device

  Try:Disconnect from the MIDI deviceTry:Close connection to EP-133
• play_note

  Play a single note with specified velocity and duration

  Try:Play a C major scaleTry:Play a high A note with velocity 100Try:Play a low G note for 2 seconds
• play_pattern

  Play a sequence of notes with timing information

  Try:Play a pattern of C, E, G notesTry:Play an ascending scaleTry:Play a simple melody
• play_drum_pattern

  Play a text-based drum pattern

  Try:Play a drum pattern with kick on beats 1 and 3Try:Play a hip-hop drum patternTry:Play a simple rock beat
• list_sound_categories

  View available sound categories (Kicks, Snares, etc.)

  Try:List sound categoriesTry:Show me all instrument categoriesTry:What sound types are available?
• list_sounds_in_category

  Browse sounds within a specific category

  Try:List sounds in Kicks categoryTry:Show me all snare soundsTry:What sounds are in the percussion category?
• get_default_pad_configuration

  See which sounds are mapped to each pad by default

  Try:Show default pad configurationTry:What sound is mapped to pad A?Try:List all default pad mappings

Comparable tools

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 .

{
  "mcpServers": {
    "koii": {
      "command": "python",
      "args": ["koii_server.py"]
    }
  }
}

FAQ

How do I connect to my EP-133 device?

Use the 'Connect to a MIDI device' command, specifying the device name or port number. Make sure your device is connected via USB and powered on.

What drum pattern syntax is supported?

The server supports four reference methods: pad references (A., A2, etc.), MIDI note numbers (36, 40, etc.), sound names ('MICRO KICK', 'NT SNARE', etc.), and mixed references. Use 'x' for hits, 'o' for soft hits, and '.' for no hit.

Compare mcp-koii with