星战科技xingzhan.cloud
返回市场
能顿副驾mcp服务器

能顿副驾mcp服务器

作者：xiaolaa248 星标更新：2025-06-21
安装使用来源：spider==github.com

项目介绍

ableton-copilot-mcp

<div align="center"> <img src="https://img.shields.io/badge/Ableton%20Live-12-9cf" alt="Ableton Live 版本"> <img src="https://img.shields.io/badge/Node.js-20%2B-green" alt="Node.js 版本"> <img src="https://img.shields.io/badge/TypeScript-5.8.2-blue" alt="TypeScript 版本"> <img src="https://img.shields.io/badge/License-MIT-yellow" alt="许可证"> </div>

一个基于 ableton-js 的MCP（模型上下文协议）服务器，用于实时与Ableton Live的编排视图进行交互和控制，旨在帮助音乐制作人进行音乐创作。

🎯 注意事项

作为一名音乐制作人，我对使用Ableton进行音乐创作有一定的了解。在创作过程中，我们经常需要处理各种繁琐的操作，如人性化音符属性、合并音符、将一条轨道录音到另一条音频轨道等。以前，我们只能依赖宿主DAW提供的功能来完成这些操作。然而，随着大型语言模型和MCP的出现，我们现在有了让AI帮助我们实现自动化的可能性。尽管目前还不现实让AI直接生成音符或创建完整的歌曲（它不能生成听起来很好的歌曲），但有AI辅助我们进行辅助操作，这为我们提供了一种新的可能性。

🎥 演示

这是一个简单的MIDI操作演示视频。

https://github.com/user-attachments/assets/8d635c4c-a1f2-44be-93ae-062038d14c71

🚀 功能

🎵 歌曲控制

  • 获取基本歌曲信息（根音、音阶名称、速度、歌曲长度等）
  • 获取所有轨道列表
  • 创建MIDI、音频和返回轨道
  • 删除和复制轨道

🎹 轨道管理

  • 获取轨道中的所有片段
  • 在编排视图轨道中创建空的MIDI片段
  • 根据提供的样本文件路径，在轨道中创建音频片段
  • 设置轨道属性（静音、颜色、名称、启用、独奏等）
  • 将MIDI片段复制到指定轨道

🎼 片段操作

  • 获取钢琴卷帘视图中的片段
  • 获取并管理片段中的所有音符
  • 在片段中添加、删除和替换音符
  • 设置片段属性（名称、颜色、循环、循环开始、循环结束等）

🎧 音频操作

  • 支持根据时间范围录制轨道内容

🔌 设备管理

  • 加载音频效果、乐器和插件
  • 修改设备参数
  • 浏览库中的可用设备

📝 状态管理

  • 操作历史跟踪和详细日志记录
  • 支持操作回滚（当前仅支持音符操作）
  • 浏览并恢复先前状态

📝 待办事项

  • 支持自动包络调整
  • 支持更多快照类型（轨道属性、设备参数等）

⚠️ 警告

  • AI直接操作MIDI片段可能导致原始音符丢失，并且无法通过Ctrl + Z撤销。请谨慎操作。如有需要，可以请求AI帮助您回滚音符操作。

📥 安装

先决条件

  • Node.js 环境：确保已安装Node.js（推荐v20+）并且npx命令可用

    🔗 下载：Node.js 官方网站

安装步骤

1. 安装AbletonJS MIDI远程脚本

选择以下三种方法之一来安装MIDI远程脚本：

  • 方法1：一键安装（推荐）

    npx @xiaolaa2/ableton-copilot-mcp --install-scripts
# 或使用简写形式
npx @xiaolaa2/ableton-copilot-mcp -is

  • 方法2：工具辅助安装

    1. 首先启动ableton-copilot-mcp（参见下面的使用部分）
    2. 让AI助手或手动调用MCP工具init_ableton_js以自动完成安装

  • 方法3：手动安装

    1. 在您的Ableton用户库中创建名为“Remote Scripts”的文件夹：
      • Windows: C:\Users\[用户名]\Documents\Ableton\User Library\Remote Scripts
      • Mac: /Users/[用户名]/Music/Ableton/User Library/Remote Scripts
    2. 从 ableton-js 项目下载MIDI远程脚本
    3. 将下载的midi-script文件夹复制到上述位置
    4. 将其重命名为AbletonJS

🔧 使用

快速开始

  1. 启动Ableton Live

  2. 启用AbletonJS 控制台

    • 打开Ableton Live偏好设置：偏好设置 → Link/MIDI
    • 在MIDI标签页中，找到控制台部分
    • 从下拉菜单中选择AbletonJS
    <div align="center"> <img src="./assets/images/setting.jpg" alt="Ableton Live MIDI远程脚本配置" width="80%" style="border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"> <p><em>图1：在Ableton Live配置中启用AbletonJS控制台</em></p> </div>

  3. 使用MCP客户端连接

    以下客户端可以用作MCP端点：

客户端配置

Cursor配置示例

在您的Cursor设置中添加以下配置：

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "@xiaolaa2/ableton-copilot-mcp"
    ]
}

对于最新版本：

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "@xiaolaa2/ableton-copilot-mcp@latest"
    ]
}

自定义存储路径（可选）

您可以使用BASE_PATH环境变量指定自定义数据存储位置：

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "@xiaolaa2/ableton-copilot-mcp"
    ],
    "env": {
        "BASE_PATH": "D:\\ableton_copilot_mcp"
    }
}

💡 提示：存储路径用于保存日志文件、操作历史和状态快照

✅ 兼容性测试

兼容性主要取决于ableton-js库的支持版本。

Ableton Live 版本测试状态
12.1.10✅ 已测试并运行正常
11.x⚠️ 尚未测试
10.x⚠️ 尚未测试

🤝 贡献

欢迎提交问题和贡献。请通过 GitHub Issues 提交问题或建议。

📄 许可证

此项目采用 MIT 许可证。

⚠️ 免责声明

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