星战科技xingzhan.cloud
返回市场
中部MC服务器

中部MC服务器

作者：guyko3 星标更新：2025-09-27
安装使用来源：spider==github.com

项目介绍

技术文档摘要

🎸 MIDI吉他踏板MCP服务器

Maven构建 Kotlin 许可证 MCP协议

一个强大的模型上下文协议（MCP）服务器，连接AI助手与MIDI吉他踏板。通过任何兼容MCP的AI助手使用自然语言控制你的吉他效果！

🚀 这是什么？

MIDI MCP 让你可以用自然语言控制吉他踏板：

  1. 你说："让我的延迟音效更明亮"
  2. AI助手：解析并生成 MidiCommand(channel=1, cc=5, value=100)
  3. MCP服务器：执行命令 → 发送 B0 05 64 到你的踏板
  4. 你的踏板：滤波频率增加，延迟音效变得更明亮！ 🎵

✨ 特性

  • 🎛️ 持久的踏板知识 - 存储任何吉他踏板的MIDI CC映射
  • 🤖 AI助手集成 - 支持Claude、ChatGPT或任何兼容MCP的AI
  • 🎵 真实的MIDI输出 - 向硬件发送实际的MIDI命令
  • 📦 预加载的踏板 - 包括Meris LVX延迟、Mercury X混响、Enzo X合成器、Neural DSP Quad Cortex和Eventide H90谐波器，带有完整的MIDI CC表
  • 🎛️ 预设创建 - 通过从自然语言描述中发送多个MIDI CC命令来创建完整的预设
  • 🧪 全面测试 - 覆盖真实功能的25个集中测试
  • ⚡ 干净的架构 - 将AI智能与MIDI执行分离

🏗️ 架构

┌─────────────┐  踏板配置查询    ┌─────────────┐    MIDI命令    ┌─────────────┐
│             │ ────────────────────── │             │ ─────────────────── │             │
│ AI助手       │   get_pedal("lvx")     │ MCP服务器    │  B0 05 64 (字节)   │ 吉他踏板    │
│             │ ◄───────────────────── │             │ ◄────────────────── │             │
└─────────────┘    CC映射         └─────────────┘    MIDI响应    └─────────────┘
     │                                        ▲
     └─ "让它更明亮" → CC5=100 ─────────┘

MCP服务器 暴露踏板配置并执行MIDI。AI助手 使用暴露的知识将自然语言转换为MIDI。

🚀 快速开始

先决条件

  • Java 8+
  • Maven 3.6+
  • MIDI接口（用于真实踏板）或使用模拟模式进行测试

1. 克隆并构建

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

2. 运行MCP服务器

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

3. 连接你的AI助手

Claude桌面集成

步骤1：构建项目

cd /path/to/midimcp
mvn compile

步骤2：配置Claude桌面 在你的Claude桌面配置文件中添加以下配置：

位置：~/Library/Application Support/Claude/claude_desktop_config.json

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

替换 /path/to/your/midimcp/ 为你的实际项目目录路径。

步骤3：重启Claude桌面 完全退出并重新启动Claude桌面以使配置生效。

步骤4：测试连接 重启后，你应该能看到“midi-guitar-pedals”服务器可用。你可以通过询问Claude来测试它：

  • "列出可用的吉他踏板"
  • "显示LVX延迟的参数"
  • "执行MIDI命令以使延迟更明亮"

其他兼容MCP的AI助手

配置你的AI助手连接到MCP服务器，使用适合你平台的MCP客户端。服务器提供这些工具：

  • execute_midi_command - 发送单个MIDI CC命令
  • execute_midi_commands - 发送一系列命令
  • get_pedal - 获取踏板信息和参数
  • list_pedals - 显示可用的踏板
  • add_pedal - 添加新的踏板配置
  • generate_h90_program - 生成H90程序文件（.pgm90格式）上传到Eventide H90
  • send_sysex - 直接向MIDI设备发送系统独占数据，用于预设上传或自定义消息

🎵 示例用法

添加新踏板

{
  "tool": "add_pedal",
  "arguments": {
    "manufacturer": "Strymon",
    "modelName": "Timeline", 
    "parameters": [
      {"name": "Mix", "ccNumber": 1, "description": "湿/干混合"},
      {"name": "Time", "ccNumber": 2, "description": "延迟时间"}
    ]
  }
}

执行MIDI命令

AI助手将*"让它更明亮"*转换为：

{
  "tool": "execute_midi_command",
  "arguments": {
    "pedalId": "meris_lvx",
    "ccNumber": 5,
    "value": 100,
    "description": "增加滤波频率以获得亮度"
  }
}

结果：B0 05 64 发送到踏板 → 滤波器打开 → 更明亮的延迟声音！ ✨

批量命令以实现复杂的声音

AI助手解释*"给我一个复古的回声"*并发送：

{
  "tool": "execute_midi_commands", 
  "arguments": {
    "pedalId": "meris_lvx",
    "commands": [
      {"ccNumber": 0, "value": 1, "description": "切换到磁带引擎"},
      {"ccNumber": 3, "value": 35, "description": "短延迟时间"},
      {"ccNumber": 4, "value": 20, "description": "低反馈"},
      {"ccNumber": 1, "value": 30, "description": "平衡混合"}
    ]
  }
}

Mercury X混响控制

AI助手解释*"创建一个丰富的大教堂混响"*并发送：

{
  "tool": "execute_midi_commands", 
  "arguments": {
    "pedalId": "meris_mercury_x",
    "commands": [
      {"ccNumber": 32, "value": 25, "description": "选择Cathedra混响结构"},
      {"ccNumber": 33, "value": 100, "description": "长衰减时间"},
      {"ccNumber": 1, "value": 75, "description": "高湿混合"},
      {"ccNumber": 15, "value": 40, "description": "中等前置延迟时间"}
    ]
  }
}

Enzo X合成器控制

AI助手解释*"创建一个温暖的多复音垫"*并发送：

{
  "tool": "execute_midi_commands", 
  "arguments": {
    "pedalId": "meris_enzo_x",
    "commands": [
      {"ccNumber": 22, "value": 40, "description": "切换到多复音模式"},
      {"ccNumber": 24, "value": 64, "description": "OSC1三角波"},
      {"ccNumber": 39, "value": 80, "description": "滤波器频率以获得温暖"},
      {"ccNumber": 55, "value": 90, "description": "缓慢的幅度攻击"}
    ]
  }
}

Quad Cortex场景控制

AI助手解释*"切换到干净场景并启用混响"*并发送：

{
  "tool": "execute_midi_commands", 
  "arguments": {
    "pedalId": "neural_dsp_quad_cortex",
    "commands": [
      {"ccNumber": 43, "value": 1, "description": "切换到场景B"},
      {"ccNumber": 36, "value": 127, "description": "启用脚踏开关B（混响）"},
      {"ccNumber": 47, "value": 1, "description": "切换到场景模式"}
    ]
  }
}

通过CC命令创建预设

通过发送一系列MIDI CC命令来创建完整的踏板预设。AI助手解释自然语言描述并通过发送目标CC命令序列来创建预设，从而配置踏板的所有方面。

预设创建如何工作

  1. AI查询踏板能力 通过get_pedal了解可用的CC参数
  2. AI解释自然语言 如"温暖的复古回声延迟"
  3. AI发送多个CC命令 通过execute_midi_commands配置预设
  4. 用户实时听到变化 每个CC命令调整踏板参数时
  5. 用户满意时保存预设 在踏板上

LVX延迟预设创建

AI助手解释*"创建一个温暖的复古回声延迟"*并发送：

{
  "tool": "execute_midi_commands",
  "arguments": {
    "pedalId": "meris_lvx",
    "commands": [
      {"ccNumber": 16, "value": 86, "description": "切换到磁带延迟引擎"},
      {"ccNumber": 1, "value": 85, "description": "高湿混合信号"},
      {"ccNumber": 15, "value": 35, "description": "短回声定时"},
      {"ccNumber": 19, "value": 25, "description": "低反馈以实现单次重复"},
      {"ccNumber": 21, "value": 15, "description": "微妙的磁带颤动调制"},
      {"ccNumber": 80, "value": 75, "description": "温暖/暗淡滤波器音色"},
      {"ccNumber": 62, "value": 16, "description": "轻动态压缩"}
    ]
  }
}

结果：踏板实时配置！用户可以在踏板本身上微调并保存预设。 🎛️

Mercury X混响预设创建

AI助手解释*"创建一个大型大教堂混响，带有温暖的前置延迟"*并发送：

{
  "tool": "execute_midi_commands",
  "arguments": {
    "pedalId": "meris_mercury_x",
    "commands": [
      {"ccNumber": 5, "value": 1, "description": "选择Cathedra混响结构"},
      {"ccNumber": 1, "value": 90, "description": "高湿混合信号"},
      {"ccNumber": 11, "value": 95, "description": "非常长的衰减时间"},
      {"ccNumber": 12, "value": 45, "description": "中等房间大小前置延迟"},
      {"ccNumber": 13, "value": 40, "description": "明显的前置延迟分离"},
      {"ccNumber": 25, "value": 2, "description": "温暖的管前级类型"},
      {"ccNumber": 31, "value": 1, "description": "高通滤波器以获得温暖"},
      {"ccNumber": 33, "value": 85, "description": "去除刺耳的频率"}
    ]
  }
}

Enzo X合成器预设创建

AI助手解释*"创建一个经典的多复音垫，带有缓慢的攻击"*并发送：

{
  "tool": "execute_midi_commands",
  "arguments": {
    "pedalId": "meris_enzo_x",
    "commands": [
      {"ccNumber": 5, "value": 1, "description": "选择多复音模式"},
      {"ccNumber": 1, "value": 75, "description": "平衡混合水平"},
      {"ccNumber": 11, "value": 1, "description": "振荡器1锯齿波"},
      {"ccNumber": 17, "value": 2, "description": "振荡器2三角波"},
      {"ccNumber": 24, "value": 70, "description": "中等滤波器亮度"},
      {"ccNumber": 25, "value": 20, "description": "微妙的滤波器共振"},
      {"ccNumber": 29, "value": 80, "description": "缓慢的幅度攻击"},
      {"ccNumber": 31, "value": 85, "description": "高的持续水平"},
      {"ccNumber": 32, "value": 60, "description": "中等释放时间"}
    ]
  }
}

好处：实时预设创建，即时音频反馈！用户可以听到每个参数的变化，并在保存之前进行微调。 🎵

H90谐波器程序创建

对于H90，程序创建方式不同——它生成可下载的.pgm90文件：

{
  "name": "generate_h90_program",
  "arguments": {
    "name": "以太垫",
    "algorithmA": {
      "algorithmNumber": 60,
      "parameters": {
        "mix": "0.8",
        "size": "0.9",
        "decay": "0.85"
      }
    },
    "algorithmB": {
      "algorithmNumber": 37,
      "parameters": {
        "intensity": "0.6",
        "depth": "0.4",
        "speed": "0.3"
      }
    },
    "routing": {
      "mode": "PARALLEL"
    }
  }
}

H90区别：生成二进制.pgm90文件用于上传，而不是实时MIDI控制，符合H90基于程序的架构。 📁

🎛️ 包含的踏板

Meris LVX延迟（预加载 - MIDI通道2）

完整的MIDI CC表包括：

  • 引擎选择（复古、磁带、数字、扫频、反向、音调）
  • 全局控制（混合、电平、时间、反馈）
  • 滤波（滤波器、低通）
  • 调制（速率、深度）
  • 立体声（宽度、乒乓）
  • 高级（扩散、模糊、驱动）

Meris Mercury X混响（预加载 - MIDI通道1）

完整的MIDI CC表包括：

  • 8种混响结构（超板、大教堂、弹簧、78房间/板/大厅、棱镜、重力）
  • 前置延迟系统（时间、反馈、交叉反馈、调制、阻尼、干混合）
  • 处理元素（动态、前级、滤波器、音调、调制）
  • 灵活路由（前+干、前、反馈、前罐、后位置）
  • 表达控制（6个可分配的表达踏板映射）
  • 高级功能（门控、保持修饰符、调音器、MIDI时钟同步）

Meris Enzo X合成器（预加载 - MIDI通道3）

完整的MIDI CC表包括：

  • 5种合成器模式（单音合成器、多音合成器、ARP合成器、干单音、干多音）
  • 双振荡器（独立波形、音调偏移、失谐、交叉调制）
  • 高级滤波器（梯子、状态变量、双注入噪声）
  • ADSR包络（滤波器和幅度包络，具有完整的ADSR控制）
  • 处理元素（驱动、氛围、调制，具有灵活的路由）
  • 调制效果（合唱、镶边、颤音、相位、环调制）
  • MIDI音符控制（完整的多音MIDI键盘支持，触后）

Neural DSP Quad Cortex（预加载 - MIDI通道4）

完整的MIDI CC表包括：

  • 6个DSP核心（最强大的地板建模器，4个乐器处理）
  • 神经捕获技术（捕捉真实的放大器和效果）
  • 多种模式（预设、场景、踏板、混合模式）
  • 8个脚踏开关（A-H，具有单独的启用/旁路控制）
  • 高级循环器X（最多4+分钟，切入/切出、反转、量化）
  • 表达控制（两个具有MIDI CC分配的表达踏板）
  • 程序管理（场景选择、节奏控制、调音器、现场视图）

Eventide H90谐波器（预加载 - MIDI通道8）

完整的MIDI CC表和独特的程序生成：

  • 超过70种算法跨越9个类别（延迟、失真、EQ、谐波器、循环器、调制、多、混响、合成器、实用工具）
  • 双算法引擎（同时运行两个算法，具有独立控制）
  • **程序文件