Bitwig MCP Server

Bitwig MCP Server

适用于 Bitwig Studio 的模型上下文协议（MCP）服务，可让 Claude 控制你的 DAW。

警告！本项目仍在开发中。文档与实现可能不同步，部分功能可能无法按预期工作。

功能

• AI 驱动的音乐制作：通过 MCP 使用 Claude 控制 Bitwig Studio
• 传输控制：播放、停止和设置速度
• 混音器控制：调整音量、声像以及音轨静音/取消静音
• 设备控制：操控设备参数
• 项目信息：访问音轨和设备信息
• 模板和提示词：为常见任务预先配置的工作流

安装

前置要求

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

从 GitHub 安装

# Clone the repository
git clone https://github.com/jxstanford/bitwig-mcp-server.git
cd bitwig-mcp-server

# Install dependencies
uv sync

使用

1. 配置 Bitwig Studio

1. 如有需要，添加用于 OSC 的虚拟 MIDI 设备
2. 按照 Driven by Moss 的安装说明安装 Bitwig 5.2+
3. 打开或重启 Bitwig Studio
4. 前往 Settings > Controllers
5. 点击“Add Controller”，然后选择“Open Sound Control”和“OSC”
6. 配置接收端口（默认值：8000）和发送端口（默认值：9000）
7. 启用控制器

2. 运行 Bitwig MCP Server

# Run the server with default settings
python -m bitwig_mcp_server

# Or run with custom settings
python -m bitwig_mcp_server --host 127.0.0.1 --send-port 8000 --receive-port 9000 --transport stdio --debug

3. 添加到 Claude Desktop

# Install the server in Claude Desktop
mcp install bitwig_mcp_server/__main__.py

然后打开 Claude Desktop，并从 MCP Servers 下拉菜单中选择 Bitwig MCP Server。

可用工具

Bitwig MCP Server 提供以下工具：

传输控制

• play：切换播放/暂停状态，或将其设为指定状态
• stop：停止播放
• set_tempo：设置速度（每分钟节拍数）

音轨控制

• set_track_volume：设置音轨音量（0-128）
• set_track_pan：设置音轨声像位置（0-128）
• set_track_mute：将音轨静音、取消静音或切换静音状态

设备控制

• set_device_parameter：设置设备参数值（0-128）

信息

• get_project_info：获取当前 Bitwig 项目信息
• get_tracks_info：获取项目中所有音轨的信息
• get_track_info：获取指定音轨的信息
• get_device_parameters：获取所选设备参数的信息

可用资源

• bitwig://project/info：项目信息
• bitwig://transport：传输状态
• bitwig://tracks：项目中的所有音轨
• bitwig://track/{index}：指定音轨的信息
• bitwig://devices：活动设备
• bitwig://device/parameters：所选设备的参数

示例提示词

• setup_mixing_session：使用默认设置创建新的混音会话
• create_track_template：使用指定设备和设置创建音轨模板
• optimize_track_settings：获取优化音轨设置的建议

配置

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

1. 环境变量或 .env 文件
2. 命令行参数
3. bitwig_mcp_server/settings.py 中的设置

命令行参数

python -m bitwig_mcp_server --help

开发

环境设置

# Install dev dependencies
uv sync

# Install pre-commit hooks
uv run pre-commit install

运行测试

# Run unit tests (no Bitwig required)
make test

# Run all tests including Bitwig integration tests
# (requires Bitwig Studio running with OSC enabled)
make test-all

代码质量

# Run code quality checks
make check

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

致谢

感谢 Jürgen Moßgraber 发布 Driven by Moss 软件包。本软件包借助该软件包与 Bitwig 交互。