返回市场
能动-氛围

能动-氛围

作者:androidStern7 星标更新:2025-03-20

项目介绍

安装

  1. 安装依赖:yarn 因为 ableton-js 使用它进行一些构建脚本,同时还需要安装 pnpm

npm install --global yarn brew install pnpm

  1. 在 ableton 中安装 midi-script

git clone https://github.com/leolabs/ableton-js.git && cd ableton-js && yarn ableton11:start

  1. 如果还没有的话,请克隆 ableton-vibe mcp 服务器:

git clone https://github.com/androidStern/ableton-vibe.git && cd ableton-vibe && pnpm i

  1. 构建并监视更改:

npm run build

  1. 将 mcp 配置添加到 claude。通用说明在这里

path-to-repo 替换为你克隆 ableton-vibe 的路径 至于 claude 的配置位置:在我的机器上,mcp 配置位于 ~/Library/Application Support/Claude/claude_desktop_config.json/

{
  "mcpServers": {
    "ableton-vibe": {
      "command": "node",
      "args": ["<path-to-repo>/ableton-vibe/ableton-mcp.js"]
    }
  }
}

使用

确保 Ableton 正在运行。 在尝试使用服务器之前,请重启 claude。 试着让 claude 创建一个 MIDI 轨道,索引为 0。目前就只能做这个了哈哈。

支持的 Ableton 版本

我已经测试过 Ableton 11。尚未尝试过 Ableton 12。

支持的操作系统

我只在我的 Mac 上试过。我认为你可能需要修改 ablton-mcp.ts 文件中的第 9 行,以使 Windows 下的临时目录逻辑生效,但我还没怎么考虑过这个问题。相关行如下所示:const userTempDir = execSync('getconf DARWIN_USER_TEMP_DIR').toString().trim()

调试

你可以运行 mcp 检查器来快速调试服务器:npm run inspect 然后打开输出中的 URL。检查器的使用说明在这里

运行测试添加设备脚本

test-browser.js 是一个示例脚本,用于程序化地向你的 ableton 设置中添加设备。Ableton 必须正在运行,并且必须安装了 ableton-js midi-remote 脚本。参见本文顶部的设置步骤 #2 来了解如何安装 midi-remote 脚本。

node test-browser.js

贡献

目前所有内容都在 ablton-mcp.ts 中,因此如果你要添加工具或资源,请将其放入该文件中。 不要编辑 ablton-mcp.JS 文件,你应该编辑的是 TS 文件。

下一步

  • 建立正确的构建和发布设置。应该能够通过一条命令安装所有内容。
  • 添加其余的 ableton API 作为 mcp 工具。我不希望手动完成这项工作。最好能通过编程方式发现并公开所有这些功能。
  • 添加对 ableton 12 的支持
  • 添加测试
  • 添加对其他操作系统(Windows)的支持
  • 语音控制