MCP Server Midi

🚀 MCP MIDI Server

This is a fast MCP server that allows Large Language Models (LLMs) to send MIDI sequences to any software that supports MIDI input.

🚀 Quick Start

The server creates a virtual MIDI port named "MCP MIDI Out", which can be used as a MIDI input device in any MIDI-compatible application. This means you can:

• Connect Digital Audio Workstations (DAWs) such as Ableton Live, Logic Pro, or FL Studio to this server to receive MIDI.
• Use the server to control hardware synthesizers via your computer's MIDI interface.
• Connect to any other software that accepts MIDI input (virtual instruments, lighting controllers, etc.). Just select "MCP MIDI Out" as the MIDI input device in your preferred MIDI-compatible application.

✨ Features

• Create a virtual MIDI output port.
• Send MIDI note-on/off messages.
• Send Control Change (CC) messages.
• Schedule MIDI events with precise timing.
• Serve as a MIDI input device in any MIDI-compatible application.

📦 Installation

1. Clone the repository:

   git clone <repository-url>
   cd mcp-server-midi
   

2. Create a virtual environment, activate it, and install the dependencies:

   python -m venv .venv
   source .venv/bin/activate
   
   pip install -r requirements.txt
   

3. Create a .env file and add the configuration:

   PORT=8123
   

💻 Usage Examples

Basic Usage

Run the server:

python mcp_midi_server.py

Advanced Usage

Here is an example of using the API to send a MIDI sequence:

import mcp_midi_server as mcp

# Create a MIDI server instance
server = mcp.MIDIServer()

# Define a callback function to handle MIDI input
def on_midi_input(event):
    print(f"Received MIDI event: {event}")

# Start the MIDI server and register the callback function
server.start(port=8123, on_input=on_midi_input)

# Send a note-on message
server.send_note_on(note=60, velocity=100, channel=0)

# Wait for a period of time (in seconds)
import time
time.sleep(1)

# Send a note-off message
server.send_note_off(note=60, velocity=64, channel=0)

# Stop the MIDI server
server.stop()

📚 Documentation

MCP Configuration

The server uses Server-Sent Events (SSE). Here's how to configure it:

{
  "mcpServers": {
      "midi": {
          "url": "http://localhost:8123/sse"
      }
   }
}

API Methods

Send Note On

Send a MIDI note-on message.

Parameters:

• note: MIDI note number (0 - 127).
• velocity: Note velocity (0 - 127, default 127).
• channel: MIDI channel (0 - 15, default 0).

Send Note Off

Send a MIDI note-off message.

Parameters:

• note: MIDI note number (0 - 127).
• velocity: Release velocity (0 - 127, default 64).
• channel: MIDI channel (0 - 15, default 0).

Send Control Change

Send a MIDI Control Change (CC) message.

Parameters:

• controller: CC controller number (0 - 127).
• value: CC value (0 - 127).
• channel: MIDI channel (0 - 15, default 0).

Send MIDI Sequence

Send a series of MIDI note-on/off messages at specified times.

Parameters:

• events: A list of event dictionaries. Each dictionary must contain:
  • note: MIDI note number (0 - 127).
  • velocity: Note velocity (0 - 127, default 127).
  • channel: MIDI channel (0 - 15, default 0).
  • time: The time when the event occurs (in milliseconds).

📄 License

This library is licensed under the [MIT License].