🎸 MIDI Guitar Pedal MCP Server

A powerful Model Context Protocol (MCP) server that bridges AI assistants with MIDI guitar pedals. Control your guitar effects using natural language through any MCP-compatible AI assistant!

🚀 What is this?

MIDI MCP lets you control guitar pedals using natural language:

1. You say: "Make my delay sound brighter"
2. AI Assistant: Interprets and generates MidiCommand(channel=1, cc=5, value=100)
3. MCP Server: Executes the command → Sends B0 05 64 to your pedal
4. Your Pedal: Filter frequency increases, delay sounds brighter! 🎵

✨ Features

• 🎛️ Persistent Pedal Knowledge - Store MIDI CC mappings for any guitar pedal
• 🤖 AI Assistant Integration - Works with Claude, ChatGPT, or any MCP-compatible AI
• 🎵 Real MIDI Output - Sends actual MIDI commands to hardware
• 📦 Pre-loaded Pedals - Includes Meris LVX delay, Mercury X reverb, Enzo X synthesizer, Neural DSP Quad Cortex, and Eventide H90 Harmonizer with full MIDI CC tables
• 🎛️ Preset Creation - Create complete presets via multiple MIDI CC commands sent in sequence from natural language descriptions
• 🧪 Fully Tested - 25 focused tests covering real functionality
• ⚡ Clean Architecture - Separation between AI intelligence and MIDI execution

🏗️ Architecture

┌─────────────┐  Pedal Config Query    ┌─────────────┐    MIDI Commands    ┌─────────────┐
│             │ ────────────────────── │             │ ─────────────────── │             │
│ AI Assistant│   get_pedal("lvx")     │ MCP Server  │  B0 05 64 (bytes)   │ Guitar Pedal│
│             │ ◄───────────────────── │             │ ◄────────────────── │             │
└─────────────┘    CC Mappings         └─────────────┘    MIDI Response    └─────────────┘
     │                                        ▲
     └─ "make it brighter" → CC5=100 ─────────┘

MCP Server exposes pedal configurations and executes MIDI. AI Assistant translates natural language to MIDI using the exposed knowledge.

🚀 Quick Start

Prerequisites

• Java 8+
• Maven 3.6+
• MIDI interface (for real pedals) or use mock mode for testing

1. Clone and Build

git clone https://github.com/guyko/midimcp.git
cd midimcp
mvn compile

2. Run the MCP Server

mvn exec:java
# or
./run-server.sh

3. Connect Your AI Assistant

Claude Desktop Integration

Step 1: Build the project

cd /path/to/midimcp
mvn compile

Step 2: Configure Claude Desktop Add this configuration to your Claude Desktop config file:

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "midi-guitar-pedals": {
      "command": "/path/to/your/midimcp/start-mcp-wrapper.sh",
      "args": []
    }
  }
}

Replace /path/to/your/midimcp/ with your actual project directory path.

Step 3: Restart Claude Desktop Completely quit and restart Claude Desktop for the configuration to take effect.

Step 4: Test the connection After restarting, you should see the "midi-guitar-pedals" server available. You can test it by asking Claude to:

• "List available guitar pedals"
• "Show me the parameters for the LVX delay"
• "Execute a MIDI command to make the delay brighter"

Other MCP-Compatible AI Assistants

Configure your AI assistant to connect to the MCP server using the appropriate MCP client for your platform. The server provides these tools:

• execute_midi_command - Send single MIDI CC command
• execute_midi_commands - Send multiple comman

... View full README on GitHub