BM

benjaminr/mcp-koii

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

34 stars 8 forks Качество 70 Тренд 26MIT

Сервер MCP для подростков EP-133 KO-II

Обзор

Этот проект представляет собой сервер Model Context Protocol (MCP), который выступает в качестве контроллера для Teenage Engineering EP-133 K.O. Второй сэмплер через MIDI - Подключитесь к устройству EP-133 K.O. II через MIDI - воспроизводите заметки и шаблоны с помощью текстовых команд - Просмотр конфигурации панели по умолчанию для понимания отображения звука - Создание и воспроизведение шаблонов барабанов с помощью простого текстового синтаксиса - Поддержка нескольких методов ссылки на инструменты (метки панели, заметки MIDI, имена инструментов, имена звуков) - Одновременное воспроизведение нескольких инструментов в шаблонах барабанов - Интеграция с Claude через MCP Python 3.8 или более поздний - mido (MIDI-обработка) - mcp (Model Context Protocol SDK) 1 Убедитесь, что ваш EP-133 K.O. II подключен к компьютеру через USB. 2.Запустите Claude Desktop с включенным MCP. 3. Начните контролировать EP-133 K.O.

Обзор (машинный перевод)

Сделать биты, песни и звуки для Teenage Engineering EP-133 K.O. II, с Клодом.

MCP-сервер, который позволяет Клоду делать биты и песни с вами на EP-133 K.O. II по MIDI. Вы говорите о музыке; Клод пишет шаблоны в небольшой, строгой текстовой нотации, играет Они на вашем устройстве, зацикливают их, пока вы итерируете, и устраивают их в песни.

##Установка

Требуется Python 3.9-3.12 и EP-133, подключенный через USB-C (Python 3.13 также работает). python-rtmidi, который разговаривает с аппаратным обеспечением MIDI, пока не имеет готовых колес для него и Составлено из источника.

Код Клода: [[Т1]].

Создание музыки

Спроси Клода что-нибудь вроде “подключайся к моему K.O. II и давай сделаем медленный удар “бум-бап”” Или же использовать [2]. Типичный сеанс:

  1. connect(): находит EP-133 автоматически. open_visualiser() показывает его вживую. 2.Клод пишет шаблон, проверяет его check_pattern и запускает play(..., loop=True). 3.Ты говоришь, что изменить. Каждый новый play переключается ** в конце текущего цикла**, Поэтому канавка никогда не останавливается, пока вы итерируете.
  2. “save pattern” (“стих”)…

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

koii studio

Make beats, songs and sounds for the Teenage Engineering EP-133 K.O. II, with Claude.

An MCP server that lets Claude make beats and songs with you on an EP-133 K.O. II over MIDI. You talk about the music; Claude writes patterns in a small, strict text notation, plays them on your device, loops them while you iterate, and arranges them into songs.

@bpm 92
@swing 58

kick:  x... ..x. x... ....
snare: .... x... .... x..o
hat:   x.x. x.x. x.x. x.xX

Install

Requires Python 3.9–3.12 and an EP-133 connected over USB-C. (Python 3.13 works too, but python-rtmidi, which talks to the MIDI hardware, has no prebuilt wheels for it yet and will compile from source.)

git clone https://github.com/benjaminr/mcp-koii.git
cd mcp-koii
uv venv --python 3.12 .venv
uv pip install -r requirements.txt

# Add to Claude Desktop
mcp install koii_studio_server.py --name koii-studio -e .

# Or try it in the MCP inspector
mcp dev koii_studio_server.py -e .

For Claude Code: claude mcp add koii-studio -- /path/to/mcp-koii/.venv/bin/python /path/to/mcp-koii/koii_studio_server.py.

Making music

Ask Claude something like “connect to my K.O. II and let’s make a slow boom-bap beat”, or use the make_a_beat prompt. A typical session:

  1. connect(): finds the EP-133 automatically. open_visualiser() shows it all live.
  2. Claude writes a pattern, checks it with check_pattern, and runs play(..., loop=True).
  3. You say what to change. Each new play switches at the end of the current loop, so the groove never stops while you iterate.
  4. save_pattern("verse", ...) keeps versions you like (saved to ~/.koii-studio/library.json).
  5. save_song("track", "intro x2, verse x4, verse+bassline x4, chorus x8, outro") and play("track").
  6. export_midi("track") writes a .mid file for your DAW.

The visualiser

The server also runs a live page at http://127.0.0.1:8133 (ask Claude to open_visualiser). It shows everything that happens, whoever does it: Claude’s tool calls, your edits, and pads you press on the device.

It has four views, one per job, switched from the top bar (and linked: #beat, #song, #sounds, #device). GUIDE.md walks through each one with annotated screenshots.

View For What’s in it
Beat making a pattern the device simulator and keyboard, the pattern editor, the pattern list
Song arranging the song picker and arranger grid, the pattern list to drag from
Sounds making sounds the sound designer, sampler and kit maker
Device what’s on the EP-133 the open project and all 48 of its pads (click one to change it), packs, the sample library and backups
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →