STARWARCLOUD STARWAR.AI
返回市场
ableton-mcp服务器

ableton-mcp服务器

作者：ahujasid2021 星标更新：2025-03-27
安装使用来源：spider==github.com

项目介绍

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

smithery 徽章

AbletonMCP 将 Ableton Live 与 Claude AI 通过模型上下文协议（MCP）连接起来，使 Claude 能够直接与 Ableton Live 进行交互和控制。这种集成支持提示辅助音乐制作、音轨创建和 Live 会话操作。

加入社区

提供反馈，获得灵感，并在 MCP 上构建：Discord。由 Siddharth 制作。

功能

  • 双向通信：通过基于套接字的服务器将 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 安装

要通过 Smithery 自动安装 Claude Desktop 的 Ableton Live 集成：

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

Claude Desktop 集成

按照设置说明视频进行操作

  1. 前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 并包含以下内容：
{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": [
                "ableton-mcp"
            ]
        }
    }
}

Cursor 集成

运行 ableton-mcp 而不通过 uvx 永久安装它。前往 Cursor 设置 > 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/[用户名]/Library/Preferences/Ableton/Live XX/User Remote Scripts

    对于 Windows：

    • 方法 1： C:\Users[用户名]\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\ 注意：将 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 一起使用

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

功能

  • 获取会话和音轨信息
  • 创建和修改 MIDI 和音频音轨
  • 创建、编辑和触发片段
  • 控制播放
  • 从 Ableton 浏览器加载乐器和效果
  • 向 MIDI 片段添加音符
  • 更改节拍和其他会话参数

示例命令

这里有一些你可以要求 Claude 执行的例子：

  • "创建一个 80 年代合成波音轨" 演示
  • "创建一个 Metro Boomin 风格的嘻哈节拍"
  • "创建一个新的带有合成贝斯乐器的 MIDI 音轨"
  • "给我的鼓添加混响"
  • "创建一个四小节带有简单旋律的 MIDI 片段"
  • "获取当前 Ableton 会话的信息"
  • "将 808 鼓架加载到选定的音轨"
  • "向第 1 音轨的片段添加爵士和弦进程"
  • "将节拍设置为 120 BPM"
  • "播放第 2 音轨的片段"

故障排除

  • 连接问题：确保 Ableton 远程脚本已加载，并且 MCP 服务器已在 Claude 上配置
  • 超时错误：尝试简化请求或将它们分解为更小的步骤
  • 重启是否解决问题？：如果你仍然遇到连接错误，请尝试重新启动 Claude 和 Ableton Live

技术细节

通信协议

该系统使用基于 JSON 的简单协议通过 TCP 套接字进行通信：

  • 命令作为具有 type 和可选 params 的 JSON 对象发送
  • 响应是具有 status 和 result 或 message 的 JSON 对象

局限性及安全考虑

  • 创建复杂的音乐编排可能需要将其分解为更小的步骤
  • 该工具旨在与 Ableton 的默认设备和浏览器项目一起工作
  • 在进行大量实验之前，请务必保存您的工作

贡献

欢迎贡献！请随时提交拉取请求。

免责声明

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