BM

benjaminr/mcp-koii

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

34 stars 8 forks 品質 70 トレンド 26MIT

ティーネージエンジニアリング向け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 プロンプトを使用します。 典型的なセッション:

  1. [connect():EP-133を自動的に見つけます。 [[open_visualiser()]は、すべてのライブを表示します。
  2. クロードはパターンを書き、[check_pattern]でチェックし、[play(..., loop=True)]を実行します。
  3. 何が変化するかと言う。 各新しい [`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:

  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 のガイドから始めましょう →