mcp-koii

概述

这个 MCP 服务器通过 MIDI 命令实现与 Teenage Engineering EP-133 K.O. II 采样器的交互。它提供了播放单个音符、创建基于文本语法的鼓模式和浏览可用声音的功能。服务器支持多种引用乐器的方式（垫子标签、MIDI 音符、乐器名称、声音名称），并允许同时播放多个乐器。与 Claude Desktop 的集成允许使用自然语言控制设备。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• list_midi_ports

  List available MIDI ports on your system

  试试:List available MIDI ports试试:Show me MIDI devices connected to my computer
• connect_midi_device

  Connect to a MIDI device by name or port number

  试试:Connect to the EP-133 device试试:Connect to MIDI port 1试试:Connect to my KO-II sampler
• disconnect_midi_device

  Close the connection to the current MIDI device

  试试:Disconnect from the MIDI device试试:Close connection to EP-133
• play_note

  Play a single note with specified velocity and duration

  试试:Play a C major scale试试:Play a high A note with velocity 100试试:Play a low G note for 2 seconds
• play_pattern

  Play a sequence of notes with timing information

  试试:Play a pattern of C, E, G notes试试:Play an ascending scale试试:Play a simple melody
• play_drum_pattern

  Play a text-based drum pattern

  试试:Play a drum pattern with kick on beats 1 and 3试试:Play a hip-hop drum pattern试试:Play a simple rock beat
• list_sound_categories

  View available sound categories (Kicks, Snares, etc.)

  试试:List sound categories试试:Show me all instrument categories试试:What sound types are available?
• list_sounds_in_category

  Browse sounds within a specific category

  试试:List sounds in Kicks category试试:Show me all snare sounds试试:What sounds are in the percussion category?
• get_default_pad_configuration

  See which sounds are mapped to each pad by default

  试试:Show default pad configuration试试:What sound is mapped to pad A?试试:List all default pad mappings

可对比工具

安装

# 安装所需的包
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 .

{
  "mcpServers": {
    "koii": {
      "command": "python",
      "args": ["koii_server.py"]
    }
  }
}

FAQ

如何连接到我的 EP-133 设备？

使用'连接到 MIDI 设备'命令，指定设备名称或端口号。确保您的设备已通过 USB 连接并已通电。

支持什么鼓模式语法？

服务器支持四种引用方式：垫子引用（A.、A2 等）、MIDI 音符编号（36、40 等）、声音名称（'MICRO KICK'、'NT SNARE' 等）和混合引用。使用'x'表示重击，'o'表示轻击，'.'表示不击打。

mcp-koii 对比