JinDaGe - bitwig-mcp-server MCP Details

article

README

🚀 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

如果需要，添加一个虚拟 MIDI 设备用于 OSC
按照 Driven by Moss 的安装说明配置 Bitwig 5.2+
打开或重新启动 Bitwig Studio
转到设置 > 控制器
点击“添加控制器”并选择“Open Sound Control”和“OSC”
配置接收端口（默认：8000）和发送端口（默认：9000）
启用该控制器

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

📚 详细文档

配置

服务器可以通过以下方式配置：

环境变量或 .env 文件
命令行参数
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 交互。

bitwig-mcp-server