Ableton MCP 集成安装与配置指南

Ableton MCP 集成安装与配置指南

ableton-mcp 项目地址: https://gitcode.com/gh_mirrors/ab/ableton-mcp

1. 项目基础介绍

Ableton MCP 是一个开源项目，它通过模型上下文协议（Model Context Protocol，简称 MCP）将 Ableton Live 与 Claude AI 相连接。这种集成允许 Claude AI 直接与 Ableton Live 互动，并控制 Live，实现辅助音乐制作、音轨创建和会话操作。

该项目主要使用 Python 编程语言。

2. 项目使用的关键技术和框架

• MIDI Remote Script：用于创建与 Ableton Live 的通信接口。
• 模型上下文协议（MCP）：一种允许不同应用程序之间通信的协议。
• TCP Sockets：用于在 MCP 服务器和 Ableton Remote Script 之间传输命令和数据。

3. 安装和配置准备工作

在开始安装之前，请确保您已经安装以下必要软件：

• Ableton Live 10 或更高版本
• Python 3.8 或更高版本
• uv 包管理器：如果您使用的是 macOS，可以通过 Homebrew 安装 uv：brew install uv。对于其他操作系统，请从 uv 的官方网站下载并安装。

安装步骤

步骤 1：安装 Ableton Remote Script

1. 访问项目仓库，下载 AbletonMCP_Remote_Script/__init__.py 文件。

2. 找到您的 Ableton Live 安装目录中的 MIDI Remote Scripts 文件夹。以下是不同操作系统下的可能位置：

   • macOS:
     • 方法 1：打开 Applications，右键点击 Ableton Live 应用程序，选择 "Show Package Contents"，然后导航至 Contents/App-Resources/MIDI Remote Scripts/。
     • 方法 2：如果方法 1 不适用，使用以下路径（将 XX 替换为您的版本号）： /Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts
   • Windows:
     • 方法 1：C:\Users\[Username]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts
     • 方法 2：C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\
     • 方法 3：C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\

3. 在 Remote Scripts 文件夹中创建一个名为 "AbletonMCP" 的新文件夹，并将下载的 __init__.py 文件复制到这个文件夹中。

4. 启动 Ableton Live，然后进入 "Settings/Preferences" > "Link, Tempo & MIDI"。

5. 在 "Control Surface" 下拉菜单中选择 "AbletonMCP"。

6. 将 "Input" 和 "Output" 都设置为 "None"。

步骤 2：配置 MCP 服务器

1. 根据 README.md 文件中的说明，在 Claude Desktop 或 Cursor 中配置 MCP 服务器。
2. 确保在 Claude Desktop 或 Cursor 中只运行一个 MCP 服务器实例。

步骤 3：使用集成

• 确保 Ableton Remote Script 已在 Ableton Live 中加载。
• 确保 MCP 服务器已在 Claude Desktop 或 Cursor 中配置。
• 与 Claude 互动时，连接应该会自动建立。

现在，您应该已经成功安装并配置了 Ableton MCP 集成，可以开始使用它来辅助您的音乐制作了。如果遇到任何连接问题，请检查 Remote Script 是否已加载，并确认 MCP 服务器是否已正确配置。如果问题仍然存在，尝试重启 Claude 和 Ableton Live。

ableton-mcp 项目地址: https://gitcode.com/gh_mirrors/ab/ableton-mcp