
benjaminr/mcp-koii
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
ティーネージエンジニアリング向けMCPサーバー EP-133 KO-II
概要
このプロジェクトは、ティーンエイジエンジニアリングEP-133 K.Oのコントローラとして機能するモデルコンテキストプロトコル(MCP)サーバーです。 MIDIによるIIサンプラー - MIDI - テキストコマンドでメモとパターンを再生 - EP-133 K.O. IIデバイスに接続 - サウンドマッピングを理解するデフォルトのパッド構成 - 簡単なテキストベースの構文でドラムパターンを作成および再生 - 複数の楽器リファレンスメソッド(パッドラベル、MIDIノート、楽器名、サウンド名)のサポート - 複数の楽器の同時再生 - MCPを介してClaudeとの統合 - Python 3.8 以降 - MIDI ハンドリング - mcp (Model Context Protocol SDK) 1。 EP-133 K.O. IIがUSB経由でコンピュータに接続されていることを確認してください。 2. MCP で Claude デスクトップを起動します。 3. EP-133 K.O の制御を始めて下さい.
概要(AI 翻訳)
ティーンエイジエンジニアリングEP-133 K.O. IIのビート、曲、サウンドを作ろう。
Claude が EP-133 K.O. II を MIDI 上に作成する MCP サーバー。 あなたは音楽について話します; クロードは、小さな、厳密なテキストの表記でパターンを書きます, 遊びます デバイス上でそれらをループし、繰り返しながらそれらをループし、それらを曲に整理します。
インストール
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 に接続して、スローブームバップのビートを作ろう」* など
または [make_a_beat プロンプトを使用します。 典型的なセッション:
- [
connect():EP-133を自動的に見つけます。 [[open_visualiser()]は、すべてのライブを表示します。 - クロードはパターンを書き、[
check_pattern]でチェックし、[play(..., loop=True)]を実行します。 - 何が変化するかと言う。 各新しい [`play` は、現在のループの最後に ** を切り替えます**、 あなたが反復しながら溝は止まらないので。 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:
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 のガイドから始めましょう →