使用说明

项目简介

Ableton Vibe MCP服务器是一个基于Model Context Protocol (MCP) 构建的服务器应用，它将Ableton Live音乐制作软件的功能以资源和工具的形式暴露给LLM客户端。通过这个服务器，LLM可以查询Ableton Live的歌曲信息，例如节拍速度和播放状态，也可以控制Ableton Live，例如创建新的MIDI轨道。

主要功能点

资源 (Resources)：
- 'ableton://song' 资源：提供当前Ableton Live工程的歌曲信息，包括节拍速度（Tempo）和播放状态（isPlaying）。
工具 (Tools)：
- 'create_midi_track' 工具：允许LLM客户端在Ableton Live中创建新的MIDI轨道。可以指定轨道创建的位置索引，默认为最后。

安装步骤

安装 Yarn: 由于项目依赖的 'ableton-js' 使用 Yarn 进行构建脚本管理，请确保已安装 Yarn。如果未安装，请运行命令 'npm install --global yarn' 进行全局安装。
安装 Ableton Live MIDI Script: 'ableton-js' 库需要 Ableton Live 中安装 MIDI Script 才能正常工作。请按照仓库 'README.md' 中的指示进行安装。步骤如下：
```
git clone https://github.com/leolabs/ableton-js.git && cd ableton-js && yarn ableton11:start
```
请注意，可能需要根据您使用的Ableton Live版本选择合适的启动命令（例如 'ableton10:start'）。

服务器配置

为了让MCP客户端连接到 Ableton Vibe MCP服务器，您需要在客户端中配置服务器的启动信息。以下是一个JSON格式的配置示例，您可以将其添加到MCP客户端的服务器列表中。

{
  "serverName": "AbletonMCP",
  "command": "node",
  "args": [
    "ableton-mcp.js"
  ],
  "transport": "stdio"
}

配置参数说明:

'serverName': 服务器的名称，这里设置为 "AbletonMCP"。
'command': 启动服务器的命令，这里使用 'node' 来运行 JavaScript 文件。
'args': 启动命令的参数列表，这里指定运行 'ableton-mcp.js' 文件。请确保 'ableton-mcp.js' 文件位于MCP客户端能够找到的路径下，或者使用绝对路径。
'transport': MCP服务器使用的传输协议，这里设置为 'stdio'，表示使用标准输入输出进行通信。

注意:

确保您的环境中已安装 Node.js 运行环境。
您可能需要先在包含 'ableton-mcp.js' 文件的目录下运行 'npm install @modelcontextprotocol/sdk ableton-js zod' 来安装项目依赖。

基本使用方法

启动 Ableton Vibe MCP服务器: 在终端中，导航到包含 'ableton-mcp.js' 文件的目录，并运行命令 'node ableton-mcp.js' 启动服务器。服务器将通过标准输入输出与MCP客户端通信。
配置并启动 MCP 客户端: 在您的MCP客户端应用中，根据上述 “服务器配置” 部分的说明，添加并配置 Ableton Vibe MCP服务器。启动客户端后，客户端应该能够自动连接到 Ableton Vibe MCP服务器。
使用 LLM 客户端与 Ableton Live 交互: 通过LLM客户端，您可以发送MCP请求来访问 'ableton://song' 资源以获取歌曲信息，或者调用 'create_midi_track' 工具来创建新的MIDI轨道，从而实现通过LLM控制 Ableton Live 的功能。

关键词