使用说明

项目简介

Elektron MCP服务器是一个专为Elektron Digitone合成器设计的MCP服务器实现。它通过MIDI协议与Digitone连接，并将合成器的各种参数（如振荡器、滤波器、效果器等）暴露为工具 (Tools)，供支持MCP协议的LLM客户端（如Claude）调用。这使得LLM能够实时控制Digitone合成器，进行声音设计、音乐创作等任务。

主要功能点

MIDI控制接口: 提供对Elektron Digitone合成器的完整MIDI控制，包括各种合成引擎和参数。
参数化工具: 将Digitone的合成参数以结构化的方式暴露为MCP工具，方便LLM进行调用和操作。
模块化架构: 采用模块化设计，易于扩展到其他Elektron设备。
参数验证: 使用Pydantic进行参数类型验证，确保数据安全性和可靠性。

安装步骤

安装Python: 确保已安装 Python 3.10 或更高版本。
安装uv: 按照仓库README.md中的指引安装 'uv' 包管理器 (macOS: 'brew install uv', Windows: 参照uv安装指南)。
安装Elektron MCP服务器: 使用 'uv pip install elektron-mcp' 命令安装服务器。
连接Digitone: 通过USB线将Elektron Digitone合成器连接到运行服务器的电脑。
安装Claude Desktop: 如果需要与Claude AI集成，请安装 Claude Desktop 应用。

服务器配置

要将Elektron MCP服务器配置为MCP客户端（如Claude Desktop）可连接的服务器，您需要在客户端的配置文件中添加以下JSON配置。以Claude Desktop为例，在 'claude_desktop_config.json' 文件中配置 'mcpServers' 字段：

{
  "mcpServers": {
    "Digitone 2": {  // 服务器名称，客户端显示用，可以自定义
      "command": "uvx", // 启动服务器的命令，这里使用 uvx 运行已安装的 elektron-mcp
      "args": ["elektron-mcp"] // 命令参数，这里 elektron-mcp 是服务器的入口点
    }
  }
}

参数注释:

'"Digitone 2"': 服务器的名称，会在MCP客户端的界面上显示，您可以自定义这个名称。
'"command": "uvx"': 指定启动MCP服务器的命令。'uvx' 用于运行通过 'uv pip install' 安装的可执行程序。
'"args": ["elektron-mcp"]': 命令的参数，'elektron-mcp' 是Elektron MCP服务器的入口程序名。

基本使用方法

启动服务器: 确保Elektron Digitone已连接并开机。在终端中运行 'uvx elektron-mcp' 命令启动Elektron MCP服务器。服务器将检测MIDI连接，并在终端输出连接状态。
配置MCP客户端: 打开您的MCP客户端（如Claude Desktop），按照客户端的使用说明配置MCP服务器连接。通常需要填入服务器名称以及上面提供的JSON配置信息。
连接服务器: 在MCP客户端中连接到已配置的 "Digitone 2" 服务器。
LLM控制Digitone: 连接成功后，您可以使用LLM客户端提供的界面或指令，调用Elektron MCP服务器提供的工具，控制Digitone合成器的各种参数，进行声音设计和音乐创作。例如，您可以指示Claude "将Digitone的振荡器1的音高设置为中央C"。

注意: 首次使用可能需要查阅Claude Desktop或其他MCP客户端的具体操作文档，以了解如何在客户端界面上正确配置和使用MCP服务器。

关键词