Ableton Live Mcp Server

Ableton Live Mcp Server

🚀 能力登 Live MCP 服务器

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

使用 LLM 控制能力登 Live

🚀 快速开始

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

  • 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 文件。

👏 鸣谢

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

TODO

  • 探索 资源提示 原型机会。
  • 构建一个独立的 能力登 Live MCP 客户端。
  • 0 关注
  • 0 收藏,9 浏览
  • system 提出于 2025-09-18 14:00

相似服务问题