🎛️ Ableton食谱-MCP服务器
分享和发现Ableton Live制作食谱 -一个模型上下文协议（MCP）服务器，将AI助手与Ableton Live连接起来，实现版本控制、机架分析和音乐制作工作流程的实时控制。
该项目使AI助手能够通过模型上下文协议（MCP）与Ableton Live进行交互，将实时控制、离线分析、版本跟踪和机架解析结合到一个统一的工作流智能系统中。
视觉
思考 Spotify Wrapped与Stack Overflow合作进行音乐制作一个平台，制片人通过以下方式分享和发现Ableton的工作流程：
- 🎛️ 机架分析 -将设备链解析并共享为“食谱”
- 📚 版本控制 -使用语义版本控制跟踪项目演变
- 🌍 集体智慧 -查询数千个项目的匿名数据
- 🤖 AI驱动的洞察 -获取混合建议、设备推荐和工作流程模式
项目结构
带npm工作区的Mono仓库：
ableton-cookbook-mcp/
├── packages/
│ ├── mcp-server/ # TypeScript MCP Server 🟢 ACTIVE
│ │ ├── src/
│ │ │ ├── index.ts # Main MCP server (16 tools)
│ │ │ ├── archivist.ts # Offline .als parsing
│ │ │ ├── operator.ts # Real-time Live control
│ │ │ ├── historian.ts # Version control bridge
│ │ │ └── analyzer.ts # Rack/preset analysis bridge
│ │ └── dist/ # Compiled JavaScript
│ │
│ ├── python-scripts/ # Version Control System 🟢 ACTIVE
│ │ ├── ableton_version_manager.py
│ │ ├── ableton_visualizer.py
│ │ └── ableton_diff.py
│ │
│ └── php-analyzers/ # Rack/Preset Parsers 🟢 ACTIVE
│ ├── abletonRackAnalyzer/
│ ├── abletonDrumRackAnalyzer/
│ ├── abletonPresetAnalyzer/
│ └── abletonSessionAnalyzer/
│
├── .claude/ # AI context & planning docs
│ ├── PROJECT_CONTEXT.md
│ ├── ARCHITECTURE.md
│ ├── VISION_AND_ROADMAP.md
│ └── WEEK_1_IMPLEMENTATION.md
│
├── docs/ # GitHub Pages documentation
├── .github/
│ ├── workflows/ # CI/CD automation
│ └── ISSUE_TEMPLATE/ # Bug/feature templates
│
└── cookbook-website/ # Laravel Web Platform (symlink)
└── → (External Laravel project)特性
🗄️ 档案员（离线分析）
- 扫描目录中的Ableton Live Set（.als）文件
- 无需打开Live即可解析和检查.als文件
- 从项目文件中提取轨迹、设备和场景信息
🎛️ 操作员（现场控制）
- 实时连接到正在运行的Ableton Live实例
- 查询传输状态（节奏、播放状态、歌曲时间）
- 列出所有带有名称、颜色和ID的曲目
- 控制混合器参数（体积等）
📚 历史学家（版本控制）
- 跟踪Ableton项目的版本历史
- 比较任意两个版本以查看更改
- 生成详细的更改报告（跟踪添加/删除、设备更改）
- 创建HTML时间线可视化
- 自动版本扫描和元数据集成
🔬 分析仪（机架和预设分析）
- 解析Ableton机架文件（.adg）以提取设备链和宏
- 使用垫分配和样本映射分析鼓架
- 检查设备预设（.adv）以查看参数设置
- 扫描用户库以查找所有机架、预设和工作流
- 按设备类型搜索机架（使用特定插件查找所有机架）
- 检测版本要求（简介/标准/套件）
先决条件
1.Node.js
请确保您已安装Node.js（v18或更高版本）。
2.Ableton Live& ableton-js 远程脚本
此服务器使用 ableton-js 图书馆与Live通信。为此，您必须安装官方的MIDI远程脚本。
- 定位
node_modules/ableton-js/midi-script此项目中的文件夹（运行后npm install). - 复制
AbletonJS文件夹到您的Ableton Live“MIDI远程脚本”目录：
- macOS： /Applications/Ableton Live 11 Suite.app/Contents/App-Resources/MIDI Remote Scripts/ 快速开始
安装
# Clone the repository
git clone https://github.com/teamallnighter/ableton-cookbook-mcp.git
cd ableton-cookbook-mcp
# Install and build MCP server
cd packages/mcp-server
npm install
npm run build配置Claude桌面版
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"ableton": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/ableton-cookbook-mcp/packages/mcp-server/dist/index.js"]
}
}
}重新启动克劳德桌面 您将看到16个可用的Ableton工具！ 🎉
发展
cd packages/mcp-server
# Watch mode (auto-rebuild on changes)
npm run watch
# Lint and format
npm run lint
npm run format
# Manual build
npm run build{ “mcpServers”：{ “艾博顿直播”：{ “command”：“node”， “args”：\[“/Volumes/DEV/M4L-MCP/dist/index.js”\] } } }
After adding the configuration, restart Claude Desktop.
## Available Tools
### Offline Analysis (Archivist)
- **scan_project_files** - Find all .als files in a directory
- **inspect_als** - Parse an .als file to extract structure
### Live Control (Operator)
- **get_live_status** - Get transport status and tempo
- **list_live_tracks** - List all tracks in the current set
- **set_track_volume** - Control track volume
### Version Control (Historian)
- **get_version_history** - Show all versions with timestamps
- **scan_versions** - Find versioned .als files (_X.Y.Z.als pattern)
- **compare_versions** - Diff two specific versions
- **get_latest_changes** - View most recent change report
- **get_change_report** - Get changes between specific versions
- **generate_timeline** - Create HTML timeline visualization
### Rack & Preset Analysis (Analyzer)
- **analyze_rack** - Extract device chains, macros, and metadata from .adg racks
- **analyze_drum_rack** - Parse drum rack pad assignments and samples
- **analyze_preset** - Inspect device preset (.adv) parameter settings
- **scan_user_library** - Index all racks, drum racks, and presets in User Library
- **search_racks_by_device** - Find racks containing specific devices (e.g., "Serum")
## Contributing
We welcome contributions! Whether you're a producer, developer, or both - your input helps make this tool better for the music production community.
**Ways to contribute:**
- 🐛 [Report bugs](https://github.com/teamallnighter/ableton-cookbook-mcp/issues/new?template=bug_report.yml)
- ✨ [Request features](https://github.com/teamallnighter/ableton-cookbook-mcp/issues/new?template=feature_request.yml)
- 📚 Improve documentation
- 🔧 Submit pull requests
- 💬 [Join discussions](https://github.com/teamallnighter/ableton-cookbook-mcp/discussions)
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
## Documentation
- 📖 **[Full Documentation](https://teamallnighter.github.io/ableton-cookbook-mcp/)** - Setup guides and examples
- 🏗️ **[Architecture](.claude/ARCHITECTURE.md)** - Technical design and data models
- 🗺️ **[Vision & Roadmap](.claude/VISION_AND_ROADMAP.md)** - Product vision and future plans
- 🔧 **[Development Guide](.claude/DEVELOPMENT.md)** - Setup, debugging, and testing
- 📋 **[Project Context](.claude/PROJECT_CONTEXT.md)** - Complete project overview
## Roadmap
- [x] **Phase 1: Proof of Concept** - MCP server with 16 tools ✅
- [ ] **Phase 2: Easy Setup** - Desktop installer for non-technical users
- [ ] **Phase 3: Community** - Web platform for sharing workflow recipes
- [ ] **Phase 4: Discovery** - Search, recommendations, and integrations
See [VISION_AND_ROADMAP.md](.claude/VISION_AND_ROADMAP.md) for detailed plans.
## License
MIT License - see [LICENSE](LICENSE) file for details.
## Acknowledgments
Built with:
- [Model Context Protocol](https://modelcontextprotocol.io/) by Anthropic
- [ableton-js](https://github.com/leolabs/ableton-js) by Leo Bernard
- Love for music production 🎵
---
**Made with 🎵 by [Team All Nighter](https://github.com/teamallnighter)**
*For producers who code at 3am*
## Example Usage
Once configured, you can ask Claude:
**Live Control:**
- "What tracks are in my current Ableton set?"
- "Set the volume of the Bass track to 0.5"
- "What's the current tempo and play state?"
**Version Control:**
- "Show me the version history for my project"
- "What changed between version 0.1.0 and 0.1.2?"
- "Generate a timeline visualization for this project"
**Rack Analysis:**
- "Analyze this rack and show me the device chain"
- "What devices are in my Bass Daddy rack?"
- "Find all racks in my User Library that use Serum"
- "Scan my User Library and show me all my custom racks"