项目简介

MIDI吉他踏板MCP服务器（midimcp）是一个基于Model Context Protocol (MCP) 构建的应用后端。它允许AI助手（如Claude、ChatGPT等兼容MCP的AI）通过自然语言命令控制各种MIDI兼容的吉他效果器踏板。该服务器托管了踏板的MIDI控制码映射信息（资源），并提供了执行MIDI命令（工具）的能力，从而实现AI对吉他音色的智能调节。

主要功能点

自然语言控制：通过AI助手，您可以直接用自然语言描述所需音色，AI将翻译成MIDI指令，由midimcp服务器发送给吉他踏板。
持久化踏板知识：内置了Meris LVX、Mercury X、Enzo X、Neural DSP Quad Cortex和Eventide H90等多种主流吉他踏板的MIDI CC（持续控制器）映射表，并支持用户添加新踏板。
实时MIDI输出：将AI生成的指令转换为实际的MIDI数据流，发送到硬件吉他踏板，实时改变音色。
预设创建：支持通过一系列MIDI CC命令，根据自然语言描述创建和配置复杂的踏板音色预设。
H90程序生成：针对Eventide H90，除了实时MIDI控制，还能生成可上传的'.pgm90'程序文件。
广泛兼容性：支持任何MCP兼容的AI助手，为LLM应用提供一个安全、可扩展的上下文服务框架。

安装步骤

准备环境：确保您的系统已安装Java 8+ 和 Maven 3.6+。如果需要控制实际的吉他踏板，还需要一个MIDI接口。

克隆仓库：

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

编译项目：
```
mvn compile
```

服务器配置

MCP服务器是供MCP客户端（如AI助手）使用的。您需要配置您的MCP客户端，使其能够启动并连接到'midimcp'服务器。以下是针对Claude Desktop的配置示例，其他MCP兼容AI助手请参考其各自的配置指南。

请将以下JSON配置添加到您的Claude Desktop配置文件中（通常位于'~/Library/Application Support/Claude/claude_desktop_config.json'），并替换路径：

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

说明：

'"midi-guitar-pedals"': 这是您为该MCP服务器定义的名称，AI助手将通过此名称识别和调用它。
'"command"': 指定了启动MCP服务器脚本的完整路径。请务必将'/path/to/your/midimcp/'替换为您的'midimcp'项目实际所在目录的路径。
'"args"': 这是一个可选的参数列表，用于向服务器启动脚本传递额外参数。在此案例中，留空即可。

配置完成后，请完全退出并重新启动您的Claude Desktop，以便配置生效。

基本使用方法

配置并重启AI助手后，您可以通过自然语言向AI助手提问，让它与'midi-guitar-pedals'服务器进行交互：

查询可用踏板：向AI提问：“列出所有可用的吉他踏板。”
获取踏板参数：向AI提问：“给我看看LVX延时踏板的参数。”
执行MIDI命令：向AI提问：“执行一个MIDI命令让延时效果听起来更明亮。” 或者：“将我的LVX设置成一个温暖的复古打板延时效果。”
创建H90程序：向AI提问：“为Eventide H90创建一个名为‘空灵音垫’的混响程序。”

AI助手会根据您的指令，调用MCP服务器提供的工具，将自然语言转换为具体的MIDI控制命令，并发送给您的吉他踏板，实时调节音色。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息