AI导哈

Ableton Live集成工具

AbletonMCP通过Model Context Protocol（MCP）将Ableton Live与Claude AI连接，实现AI辅助音乐制作、轨道创建和会话控制。

  • by amey0307
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 amey0307/ableton-mcp-server

使用说明

AbletonMCP-Ableton实时模型上下文协议集成

AbletonMCP通过模型上下文协议（MCP）将Ableton Live连接到Claude AI，使Claude能够直接与Ableton Lives交互并控制Ableton。这种集成实现了快速辅助音乐制作、曲目创建和现场会话操作。

特性

  • 双向通信：通过基于套接字的服务器将Claude AI连接到Ableton Live
  • 轨迹操纵：创建、修改和操纵MIDI和音轨
  • 仪器和效果选择：Claude可以从Ableton的库中访问和加载正确的乐器、效果和声音
  • 剪辑创建：创建和编辑带有音符的MIDI片段
  • 会话控制：启动和停止播放、播放剪辑和控制传输

组件

该系统由两个主要部分组成：

  1. Ableton远程脚本 (Ableton_Remote_Script/__init__.py)：Ableton Live的MIDI远程脚本，用于创建套接字服务器以接收和执行命令
  2. MCP服务器 (server.py)：实现模型上下文协议并连接到Ableton远程脚本的Python服务器

安装

通过Smithery安装

通过以下方式自动安装Ableton Live Integration for Claude Desktop 史密瑟里:

npx -y @smithery/cli install @ahujasid/ableton-mcp --client claude

先决条件

  • Ableton Live 10或更新版本
  • Python 3.8或更高版本
  • uv包管理器

如果您使用的是Mac，请按以下方式安装uv：

brew install uv

否则，请从[uv官方网站]安装[https://docs.astral.sh/uv/getting-started/installation/]

⚠️ 安装UV之前不要继续

  1. 转到Claude>设置>开发人员>编辑配置>Claude_desktop_Config.json，以包含以下内容：
{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": [
                "ableton-mcp"
            ]
        }
    }
}

光标集成

运行ableton mcp，而无需通过uvx永久安装。转到光标设置>MCP并将其粘贴为命令：

uvx ableton-mcp

⚠️ 只运行一个MCP服务器实例（在Cursor或Claude Desktop上），而不是两者都运行

安装Ableton远程脚本

  1. 下载 AbletonMCP_Remote_Script/__init__.py 此仓库中的文件

  2. 将文件夹复制到Ableton的MIDI远程脚本目录。不同的操作系统和版本有不同的位置。 其中一个应该有效，你可能需要看看:

    对于macOS：

    • 方法1：转到应用程序>右键单击Ableton Live应用程序→ 显示包装内容→ 导航到： Contents/App-Resources/MIDI Remote Scripts/
    • 方法2：如果第一种方法中没有，请使用直接路径（将XX替换为您的版本号）： /Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts

    对于Windows：

    • 方法1： C： \用户[用户名]\AppData\Roaming\Ableton\Live x.x.x\首选项\用户远程脚本
    • 方法2： C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\
    • 方法3： C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\ 注：将XX替换为您的Ableton版本号（例如，10、11、12）

  3. 在远程脚本目录中创建一个名为“AbletonMCP”的文件夹，并粘贴下载的“__init__.py”文件

  4. 启动Ableton Live

  5. 转到设置/首选项→ 链接、节奏和MIDI

  6. 在控制界面下拉菜单中，选择“AbletonMCP”

  7. 将输入和输出设置为“无”

用法

启动连接

  1. 确保Ableton远程脚本已加载到Ableton Live中
  2. 确保MCP服务器已在Claude Desktop或Cursor中配置
  3. 当您与Claude交互时，应自动建立连接

与克劳德一起使用

一旦在Claude上设置了配置文件，并且远程脚本在Ableton中运行，您将看到一个带有Ableton MCP工具的锤子图标。

能力

  • 获取会话和跟踪信息
  • 创建和修改MIDI和音轨
  • 创建、编辑和触发剪辑
  • 控制播放
  • 从Ableton的浏览器加载乐器和效果
  • 为MIDI片段添加注释
  • 更改节奏和其他会话参数

示例命令

以下是一些你可以要求克劳德做的事情的例子：

  • “创作一首80年代的合成波曲目”
  • “创造Metro Boomin风格的嘻哈节拍”
  • “使用合成低音乐器创建新的MIDI曲目”
  • “为我的鼓添加混响”
  • “用简单的旋律创建一个4小节MIDI片段”
  • “获取有关当前Ableton会话的信息”
  • “将808鼓架装入所选轨道”
  • “在曲目1中的剪辑中添加爵士和弦级数”
  • “将节奏设置为120 BPM”
  • “播放曲目2中的剪辑”

故障排除

  • 连接问题：确保加载了Ableton远程脚本，并且在Claude上配置了MCP服务器
  • 超时错误：尝试简化您的请求或将其分解为更小的步骤
  • 你试过把它关掉再打开吗？：如果您仍然存在连接错误，请尝试重新启动Claude和Ableton Live

技术细节

通信协议

该系统在TCP套接字上使用简单的基于JSON的协议：

  • 命令以JSON对象的形式发送，并带有 type 可选 params
  • 响应是JSON对象，具有 status 和 result 或 message

限制和安全考虑

  • 创建复杂的音乐编排可能需要分解成更小的步骤
  • 该工具旨在与Ableton的默认设备和浏览器项目配合使用
  • 在进行大量实验之前，始终保存您的工作

贡献

欢迎投稿！请随时提交拉取请求。

免责声明

这是第三方集成，不是由Ableton制作的。

相关 MCP