
benjaminr/mcp-koii
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Сервер 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]. Типичный сеанс:
connect(): находит EP-133 автоматически.open_visualiser()показывает его вживую. 2.Клод пишет шаблон, проверяет егоcheck_patternи запускаетplay(..., loop=True). 3.Ты говоришь, что изменить. Каждый новыйplayпереключается ** в конце текущего цикла**, Поэтому канавка никогда не останавливается, пока вы итерируете.- “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:
connect(): finds the EP-133 automatically.open_visualiser()shows it all live.- Claude writes a pattern, checks it with
check_pattern, and runsplay(..., loop=True). - You say what to change. Each new
playswitches at the end of the current loop, so the groove never stops while you iterate. save_pattern("verse", ...)keeps versions you like (saved to~/.koii-studio/library.json).save_song("track", "intro x2, verse x4, verse+bassline x4, chorus x8, outro")andplay("track").export_midi("track")writes a.midfile 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 |
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →