ableton-live-mcp-server

🚀 能力登 Live MCP 服务器

能力登 Live MCP 服务器 是一个实现 模型上下文协议 (MCP) 的服务器，可促进大型语言模型（LLM）与 Ableton Live 之间的通信。它借助 OSC（开放声音控制） 协议，实现与能力登 Live 之间的消息收发。此实现基于 AbletonOSC，并将可用的 OSC 地址全面映射到 工具，方便 MCP 客户端访问。

🚀 快速开始

该项目主要由两部分构成：

• mcp_ableton_server.py：作为 MCP 服务器，负责处理客户端与 OSC 代理之间的通信。
• osc_daemon.py：充当 OSC 代理，负责将命令转发至能力登 Live 并处理响应。

✨ 主要特性

• 提供兼容 MCP 的 API，支持通过 MCP 客户端对能力登 Live 进行控制。
• 采用 python-osc 实现 OSC 通信。
• 基于 AbletonOSC 实现 OSC 功能。
• 实现请求 - 响应处理机制，以处理能力登 Live 的命令。

📦 安装指南

要求

• Python 3.8 及以上版本
• python-osc（用于 OSC 通信）
• fastmcp（用于 MCP 支持）
• uv（推荐的 Python 包安装工具）
• AbletonOSC 作为控制表面

安装步骤

1. 安装 uv（https://docs.astral.sh/uv/getting-started/installation）：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 克隆仓库：

   git clone https://github.com/your-username/mcp_ableton_server.git
   cd mcp_ableton_server
   

3. 安装项目及其依赖项：

   uv sync
   

4. 安装 AbletonOSC。

🛠️ 详细文档

• mcp_ableton_server.py：是 MCP 服务器的入口。
• osc_daemon.py：作为 OSC 代理，负责处理与能力登 Live 的通信。
• resources：此文件夹包含项目所需的资源。
• LICENSE：这是许可证文件。

💻 使用示例

基础用法

以下是启动服务器和代理的示例命令：

# 启动 MCP 服务器
python mcp_ableton_server.py
# 启动 OSC 代理
python osc_daemon.py

🤑 FAQ

Q：如何配置项目？

A：请参考 CONFIG 文件。

Q：遇到问题怎么办？

A：可提交 ISSUE 或联系维护人员。

🚀 提交贡献

欢迎提交问题、功能请求或拉取请求，共同改进该项目。

📄 许可证

该项目遵循 MIT License 许可协议。有关详细信息，请参阅 LICENSE 文件。

👏 鸣谢

感谢以下项目和人物的贡献：

• 模型上下文协议 (MCP)
• python-osc 用于 OSC 处理
• Daniel John Jones 和 OSC 实现的 AbletonOSC
• 能力登第三方远程脚本
• Julien Bayle @Structure Void 的启发和资源。

TODO

• 探索 资源 和 提示 原型机会。
• 构建一个独立的 能力登 Live MCP 客户端。