BM

benjaminr/mcp-koii

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

34 stars 8 forks 품질 70 트렌드 26MIT

EP-133 KO-II 엔지니어링을 위한 MCP 서버

개요

이 프로젝트는 모델 콘텍스트 프로토콜 (MCP) 서버로, EP-133 K.O.를 엔지니어링하는 데 컨트롤러 역할을 합니다. MIDI를 통해 II 샘플러 - MIDI를 통해 EP-133 K.O. II 장치에 연결 - 텍스트 명령을 통해 메모와 패턴을 재생 - 사운드 매핑을 이해하기 위해 기본 패드 구성을보기 - 간단한 텍스트 기반 구문과 드럼 패턴 만들기 및 재생 - 여러 악기 참조 방법 지원 (패드 라벨, MIDI 노트, 악기 이름, 사운드 이름) - 드럼 패턴의 여러 악기의 동시 재생 - MCP를 통해 Claude와 통합 - Python 3.8 이상 - Mido (MIDI 처리) - mcp (모델 컨텍스트 프로토콜 SDK) 1. EP-133 K.O. II가 USB를 통해 컴퓨터에 연결되도록하십시오. 2. MCP가 활성화된 Claude 데스크톱을 시작합니다. 3. EP-133 K.O를 통제하십시오.

개요(AI 번역)

EP-133 K.O. II, Claude와 함께 토출, 노래와 소리를 만듭니다.

Claude가 EP-133 K.O. II에서 비트와 노래를 만들 수있는 MCP 서버. 음악에 대해 이야기하십시오. Claude는 작은, 엄격한 텍스트 표기, 연극에서 패턴을 작성합니다. 장치에서 그들을 반복, 당신은 그것을 거역하고 노래로 정렬.

설치

Python 3.9–3.12 및 USB-C에 연결된 EP-133을 요구합니다. (Python 3.13은 너무 작동하지만, python-rtmidi] MIDI 하드웨어에 대해 이야기하는 것은 아직 미리 만들어진 휠이 없습니다. 소스에서 컴파일한다.)

클로드 코드의 경우: claude mcp add koii-studio -- /path/to/mcp-koii/.venv/bin/python /path/to/mcp-koii/koii_studio_server.py.

음악 만들기

  • “내 K.O. II에 연결하고 느린 붐-bap 비트를 만들 수 있습니다”*, 또는 make_a_beat 프롬프트를 사용합니다. 일반적인 세션:
  1. connect(): EP-133을 자동으로 찾습니다. open_visualiser()]는 모든 라이브를 보여줍니다.
  2. Claude는 패턴을 작성하고 check_pattern]를 체크하고 play(..., loop=True)]를 실행합니다.
  3. 당신은 변화하는 것을 말합니다. 각 새로운 play 스위치 **현재 루프의 끝 **, 그래서 강저는 당신을 iterate 동안 멈추지 않습니다.
  4. `save pattern(“verse”, …

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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
GitHub에서 전체 README 보기

설치

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

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →