ahujasid/ableton-mcp

main BranchesTags Go to file Code

Folders and files

Name| Name| Last commit message| Last commit date
---|---|---|---

Latest commit

History

23 Commits
AbletonMCP_Remote_Script| AbletonMCP_Remote_Script
MCP_Server| MCP_Server
.gitignore| .gitignore
.python-version| .python-version
Dockerfile| Dockerfile
LICENSE| LICENSE
README.md| README.md
pyproject.toml| pyproject.toml
smithery.yaml| smithery.yaml
uv.lock| uv.lock
View all files

Repository files navigation

AbletonMCP - Ableton Live Model Context Protocol Integration

smithery badge AbletonMCP 通过模型上下文协议 (MCP) 将 Ableton Live 连接到 Claude AI,从而使 Claude 能够直接与 Ableton Live 交互并对其进行控制。这种集成支持提示辅助音乐制作、音轨创建和 Live 会话操作。

加入社区

提供反馈、获得灵感,并在 MCP 的基础上进行构建:Discord。由 Siddharth 制作

功能

组件

该系统由两个主要组件组成:

  1. Ableton Remote Script (Ableton_Remote_Script/__init__.py): 用于 Ableton Live 的 MIDI Remote Script,它创建一个 socket 服务器来接收和执行命令
  2. MCP Server (server.py): 一个 Python 服务器,它实现了模型上下文协议并连接到 Ableton Remote Script

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Ableton Live 集成,请执行以下操作:

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

前提条件

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

brew install uv

否则,从 [uv 官方网站][https://docs.astral.sh/uv/getting-started/installation/] 安装 ⚠️ 在安装 UV 之前不要继续

Claude for Desktop 集成

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

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

Cursor 集成

无需通过 uvx 永久安装即可运行 ableton-mcp。转到 Cursor 设置 > MCP 并粘贴此作为命令:

uvx ableton-mcp

⚠️ 仅运行一个 MCP 服务器实例(无论是在 Cursor 还是 Claude Desktop 上),而不是两者都运行

安装 Ableton Remote Script

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

  1. 从此 repo 下载 AbletonMCP_Remote_Script/__init__.py 文件
  2. 将文件夹复制到 Ableton 的 MIDI Remote Scripts 目录。不同的操作系统和版本有不同的位置。以下方法之一应该有效,您可能需要查找对于 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:\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\ 注意:将 XX 替换为您的 Ableton 版本号(例如,10、11、12)
  3. 在 Remote Scripts 目录中创建一个名为 'AbletonMCP' 的文件夹,然后粘贴下载的 'init.py' 文件
  4. 启动 Ableton Live
  5. 转到设置/偏好设置 → Link, Tempo & MIDI
  6. 在 Control Surface 下拉列表中,选择“AbletonMCP”
  7. 将输入和输出设置为“无”

用法

启动连接

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

与 Claude 一起使用

在 Claude 上设置配置文件并且 remote script 在 Ableton 中运行后,您将看到一个带有 Ableton MCP 工具的锤子图标。

功能

示例命令

以下是您可以要求 Claude 执行的一些示例:

故障排除

技术细节

通信协议

该系统使用基于 TCP socket 的简单 JSON 协议:

限制和安全注意事项

贡献

欢迎贡献!请随时提交 Pull Request。

免责声明

这是第三方集成,并非由 Ableton 制作。

关于

未提供描述、网站或主题。

资源

Readme

License

MIT license Activity

Stars

1k stars

Watchers

19 watching

Forks

118 forks Report repository

Releases

No releases published

Packages 0

No packages published

Contributors 3

Languages

Footer

© 2025 GitHub, Inc.

Footer navigation

You can’t perform that action at this time.