Bitwig MCP Server

🚀 Bitwig MCP 服務器

一個用於 Bitwig Studio 的 Model Context Protocol (MCP) 服務器，允許 Claude 控制你的數字音頻工作站（DAW），為音樂製作帶來全新的 AI 驅動體驗。

注意！這是一個正在進行中的工作。文檔和實現可能不同步，並且所有功能可能不會按預期工作。

🚀 快速開始

本服務器允許你使用 Claude 通過 MCP 控制 Bitwig Studio，實現 AI 驅動的音樂製作。以下是使用前的安裝和配置步驟。

✨ 主要特性

• AI 驅動的音樂製作：通過 MCP 使用 Claude 控制 Bitwig Studio
• 運輸控制：播放、停止和設置節拍
• 混音器控制：調整音量、聲像和靜音/取消靜音軌道
• 設備控制：操作設備參數
• 項目信息：訪問軌道和設備信息
• 模板和提示：用於常見任務的預配置工作流程

📦 安裝指南

先決條件

• Python 3.10+
• Bitwig Studio 5.2+
• Driven by Moss 5.2+
• 帶有 MCP 支持的 Claude Desktop 應用

從 GitHub 安裝

# 克隆倉庫
git clone https://github.com/jxstanford/bitwig-mcp-server.git
cd bitwig-mcp-server

# 安裝依賴項
uv sync

💻 使用示例

1. 配置 Bitwig Studio

1. 如果需要，添加一個虛擬 MIDI 設備用於 OSC
2. 按照 Driven by Moss 的安裝說明配置 Bitwig 5.2+
3. 打開或重新啟動 Bitwig Studio
4. 轉到設置 > 控制器
5. 點擊“添加控制器”並選擇“Open Sound Control”和“OSC”
6. 配置接收端口（默認：8000）和發送端口（默認：9000）
7. 啟用該控制器

2. 運行 Bitwig MCP 服務器

# 使用默認設置運行服務器
python -m bitwig_mcp_server

# 或使用自定義設置
python -m bitwig_mcp_server --host 127.0.0.1 --send-port 8000 --receive-port 9000 --transport stdio --debug

3. 添加到 Claude Desktop

# 在 Claude Desktop 中安裝服務器
mcp install bitwig_mcp_server/settings.py

📚 詳細文檔

配置

服務器可以通過以下方式配置：

1. 環境變量或 .env 文件
2. 命令行參數
3. bitwig_mcp_server/settings.py 中的設置

命令行參數

python -m bitwig_mcp_server --help

開發

環境搭建

# 安裝開發依賴項
uv sync

# 安裝預提交鉤子
uv run pre-commit install

運行測試

# 運行單元測試（無需 Bitwig）
make test

# 運行所有測試包括 Bitwig 集成測試
# （需要運行帶有 OSC 啟用的 Bitwig Studio）
make test-all

代碼質量

# 運行代碼質量檢查
make check

📄 許可證

本項目 licensed under the MIT License - 查看 LICENSE 文件以獲取詳細信息。

致謝

感謝 Jürgen Moßgraber 發佈的 Driven by Moss 包。這個包利用該包與 Bitwig 交互。