MCP Koii

🚀 Teenage Engineering EP-133 K.O. II 的 MCP 接口

本項目是一個模型上下文協議（MCP）服務器，旨在藉助 MIDI 實現對 Teenage Engineering 的 EP-133 K.O. II 採樣器的控制，為音樂創作帶來更多便利。

✨ 主要特性

• 可通過 MIDI 與您的 EP-133 K.O. II 設備建立連接。
• 支持使用文本命令播放音符和模式。
• 能夠查看默認墊配置，從而瞭解聲音映射情況。
• 可運用簡單的基於文本的語法創建並播放鼓點模式。
• 支持多種樂器參考方法，如墊標籤、MIDI 音高、樂器名稱、聲音名稱等。
• 可以同時播放多個樂器的鼓點模式。
• 能夠與 Claude 通過 MCP 實現集成。

📦 安裝指南

先決條件

• 需要 Python 3.8 或更高版本。
• 需安裝 mido（用於 MIDI 處理）。
• 需安裝 mcp（模型上下文協議 SDK）。

快速安裝

# 安裝所需的包
pip install mido "mcp[cli]"

# 克隆倉庫
git clone https://github.com/benjaminr/mcp-koii.git
cd mcp-koii

# 安裝MCP服務器
mcp install koii_server.py:server -e .

🚀 快速開始

與Claude Desktop一起使用

1. 確保您的 EP-133 K.O. II 通過 USB 連接到計算機。
2. 使用支持 MCP 的 Claude Desktop 啟動。
3. 通過向 Claude 提出自然語言問題來控制您的 EP-133 K.O. II，例如：
   • "列出可用的 MIDI 端口"
   • "連接到 EP-133 設備"
   • "播放 C 大調音階"
   • "播放鼓點模式，貝斯在節拍 1 和 3，軍鼓在 2 和 4，踩鑔在每八分音符"

開發模式下運行

您可以在開發模式下運行 MCP 服務器以進行測試，而無需 Claude Desktop：

# 帶有檢查器UI運行
mcp dev koii_server.py:server -e .

📚 詳細文檔

功能和命令

基本命令

• 列出可用的 MIDI 端口：顯示系統上所有可用的 MIDI 輸出端口。
• 連接到 MIDI 設備：通過名稱或端口號連接到 EP-133 K.O. II。
• 斷開連接：從當前連接的 EP-133 K.O. II 斷開。

音樂播放

• 設置 BPM：使用指定的節拍數設置播放速度。
• 播放音階：按順序播放給定的 MIDI 音高列表。
• 播放模式：以循環方式播放鼓點模式。

📄 許可證

該項目在 MIT 許可證下發布，有關詳細信息請參閱 LICENSE 文件。

致謝

• Teenage Engineering 提供了 EP-133 K.O. II。
• Anthropic 為 Claude 和模型上下文協議做出了貢獻。
• MIDO 提供了 MIDI 處理庫。

⚠️ 重要提示

請確保 EP-133 K.O. II 處於正確的 MIDI 模式。在進行未知樂器測試時，請使用準確的聲音名稱、墊標籤、MIDI 音高或聲音名稱。