AI导哈

AI音乐创作助手

AbletonMCP是一个强大的MCP服务器，通过Claude Desktop控制Ableton Live实现自动化音乐制作，专注于电子和工业音乐生成。

  • by FabianTinkl
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 FabianTinkl/AbletonMCP

使用说明

AbletonMCP-Ableton Live的AI音乐助手

强大的MCP（模型上下文协议）服务器，使Claude Desktop能够控制Ableton Live进行自动化音乐制作，专门从事技术和工业音乐制作。

特性

  • 自然语言音乐制作：根据文本提示创建完整曲目
  • 特定类型AI：专注于技术和工业音乐风格
  • 实时Ableton控制：通过OSC与Ableton Live完全集成
  • 智能组合：人工智能驱动的旋律、和声和节奏生成
  • 专业运输控制：播放、停止、节奏控制和项目管理

先决条件

  • Python 3.10或更高版本
  • Ableton Live 11套房 （或更高）
  • 克劳德桌面 应用
  • 至少4GB RAM用于音乐制作

分步设置指南

步骤1：安装Python依赖项

# Navigate to the project directory
cd AbletonMCP

# Install required packages
pip install -r requirements.txt

步骤2：安装AbletonOSC远程脚本

运行自动安装程序：

python install_ableton_osc.py

如果自动安装程序失败，请手动安装：

  1. 下载AbletonOSC：https://github.com/ideoforms/AbletonOSC/archive/refs/heads/main.zip
  2. 解压缩ZIP文件
  3. 复制 AbletonOSC-main 文件夹到您的Ableton远程脚本目录：
    • macOS: ~/Music/Ableton/User Library/Remote Scripts/
    • 视窗: %USERPROFILE%/Documents/Ableton/User Library/Remote Scripts/
    • Linux: ~/ableton/User Library/Remote Scripts/
  4. 重命名文件夹 AbletonOSC-main 向 AbletonOSC

步骤3：配置Ableton Live 11套件

  1. 打开Ableton Live 11套房
  2. 首选 Live → 偏好设置 （macOS）或 选项→ 偏好设置 （Windows）
  3. 点击 链接/节奏/MIDI 标签
  4. 在 控制表面 章节：
    • 将第一个下拉列表设置为 “AbletonOSC”
    • 离开 输入 和 输出 着手 “无”
  5. 点击 好的 保存设置
  6. 重新启动Ableton Live 完全

步骤4：测试您的设置

测试AI组成（无需直播）：

# Test the AI composition engine offline
python examples/offline_demo.py

测试完整系统（需要实时运行）：

# Run the comprehensive test suite  
python test_server.py

您应该看到：

  • ✅ 项目结构测试通过
  • ✅ 组合处理器测试通过
  • ✅ OSC连接测试通过（需要Live运行）
  • ✅ MCP工具测试通过

如果OSC测试失败：

  • 确保Ableton Live 11 Suite正在运行
  • 验证Live的MIDI首选项中是否选择了AbletonOSC
  • 检查端口11000/11001是否未被防火墙阻止
  • 离线演示应该仍然可以完美运行！

步骤5：启动MCP服务器

python -m mcp_server.main

您应该看到如下输出：

🎵 Starting AbletonMCP Server...
✅ AbletonTools connected successfully
INFO: MCP Server listening on stdio...

保持此终端窗口打开 -服务器需要持续运行。

步骤6：配置Claude桌面

  1. 退出克劳德桌面 完全如果它正在运行

  2. 打开您的Claude Desktop配置文件：

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %APPDATA%/Claude/claude_desktop_config.json

  3. 查找您的Python可执行文件路径:

which python

这将显示Python安装的完整路径（例如。， /Users/yourname/anaconda3/bin/python 或 /opt/homebrew/bin/python3).

  1. 创建或编辑claude_desktop_config.json文件 包含以下内容：
{
  "mcpServers": {
    "ableton-mcp": {
      "command": "/full/path/to/your/python",
      "args": ["-m", "mcp_server.main"],
      "cwd": "/full/path/to/your/AbletonMCP",
      "env": {
        "PYTHONPATH": "/full/path/to/your/AbletonMCP"
      }
    }
  }
}

重要:

  • 替换 /full/path/to/your/python 结果是 which python 命令
  • 替换 /full/path/to/your/AbletonMCP 带有AbletonMCP项目目录的实际完整路径（出现两次）
  • 这 PYTHONPATH 环境变量对于Python查找mcp_server模块至关重要
  • 使用绝对路径，而不是相对路径，如 python 或 ~/
  1. 保存文件 和 重新启动克劳德桌面

步骤7：在Claude Desktop中验证连接

  1. 打开克劳德桌面
  2. 开始新的对话
  3. 你应该看看 “AbletonMCP” 列在底部的服务器连接中
  4. 如果它显示为已连接，则表示您已准备好制作音乐！

示例提示-测试所有功能

基本运输控制

在Claude Desktop中尝试以下提示：

1.测试连接

Ping Ableton Live to test the connection

2.温度控制

Set the tempo to 132 BPM

3.运输控制

Start playback

Stop playback after 8 seconds

航迹管理

4.创建基本曲目

Create a MIDI track called "Kick Drum"

Create a MIDI track called "Bass Synth" 

Create an audio track called "Percussion"

Create a return track called "Industrial Reverb"

AI音乐生成

5.生成和弦进程

Generate a chord progression in A minor for industrial techno, 8 bars long

Generate a chord progression in D minor for minimal techno, 4 bars

6.创建鼓图案

Create an industrial drum pattern for 4 bars

7.完成歌曲生成

Create a 64-bar industrial techno song at 132 BPM in A minor

高级功能

8.项目信息

Get information about the current Ableton Live session

9.节奏变化

Set tempo to 128 BPM for underground techno

Set tempo to 140 BPM for hard techno

复杂成分

10.完整的生产流程

Create a complete techno track: Set tempo to 132 BPM, create kick, bass, lead, and percussion tracks, then generate an industrial techno song structure for 64 bars in A minor. Add atmospheric elements and start playback to preview.

Ableton Live的预期结果

运行这些提示时，您应该看到：

  1. 交通变化：BPM调整、播放/停止状态
  2. 新曲目出现：会话视图中的命名轨迹
  3. 生成MIDI剪辑：包含和弦进行和模式
  4. 控制台反馈：Claude和MCP服务器终端中的成功消息

故障排除

“无法连接到Ableton Live”

  • ✅ 确保Ableton Live正在运行
  • ✅ 验证AbletonOSC是否已安装并启用
  • ✅ 检查Live的MIDI偏好显示“AbletonOSC”已选中
  • ✅ 重新启动Live和MCP服务器

“在Claude Desktop中找不到MCP服务器”

  • ✅ 检查config.json路径是否适合您的操作系统
  • ✅ 验证“cwd”路径指向您的AbletonMCP目录
  • ✅ 确保在配置更改后重新启动Claude Desktop
  • ✅ 检查Claude Desktop的控制台是否有错误消息

“权限被拒绝”或导入错误

  • ✅ 跑 pip install -r requirements.txt
  • ✅ 使用Python 3.10或更高版本
  • ✅ 考虑使用虚拟环境

音乐生成未按预期工作

  • ✅ 这是第一阶段——基本功能
  • ✅ 尝试不同的音乐键（Am、Dm、Em、Gm）
  • ✅ 尝试不同的BPM范围（120-150）
  • ✅ 使用类型关键字：“工业”、“最小”、“地下”

后续步骤

一旦一切正常：

  1. 实验 具有不同的音乐风格和BPM
  2. 组合提示 对于复杂的安排
  3. 使用Live的工具 进一步优化人工智能生成的内容
  4. 保存您的项目 像往常一样在Ableton Live

第一阶段的工作是什么

✅ 传输控制 -播放/停止、节奏设置
✅ 轨道创建 -MIDI、音频和返回曲目
✅ AI和弦进展 -特定类型的和声生成
✅ 基本歌曲结构 -多段布置
✅ OSC通信 -实时实时控制
✅ 音乐理论整合 -连贯的音乐输出

项目结构

  • mcp_server/ -MCP服务器实现
  • ableton_control/ -OSC和Ableton Live API包装
  • music_ai/ -AI合成与生成引擎
  • audio_processing/ -音频分析和处理工具
  • knowledge_base/ -音乐理论和流派特定数据
  • samples/ -音频内容库
  • tests/ -测试套件

发展

安装开发依赖项：

pip install -r requirements.txt

运行测试：

pytest

格式代码：

black . && isort .

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

相关 MCP