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 客戶端。