Bitwig MCP 服务器

一个用于 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 安装

# 克隆存储库
git clone https://github.com/jxstanford/bitwig-mcp-server.git
cd bitwig-mcp-server

# 安装依赖项
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 服务器

# 使用默认设置运行服务器
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/__main__.py

然后打开 Claude Desktop 并从 MCP Servers 下拉列表中选择 Bitwig MCP Server。

可用工具

Bitwig MCP 服务器提供以下工具：

走带控制

• 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

开发

环境设置

# 安装开发依赖项
uv sync

# 安装 pre-commit 钩子
uv run pre-commit install

运行测试

# 运行单元测试（不需要 Bitwig）
make test

# 运行所有测试，包括 Bitwig 集成测试
# （需要运行 Bitwig Studio 并启用 OSC）
make test-all

代码质量

# 运行代码质量检查
make check

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

此项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

感谢 Jürgen Moßgraber 发布 Driven by Moss 包。此软件包利用该软件包与 Bitwig 进行交互。