Bitwig MCP Server

🚀 Bitwig MCP サーバ

Bitwig Studio 用の Model Context Protocol (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. 設定 > コントローラに移動します。
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

🤝 貢献

貢献は大歓迎です！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

🙏 謝辞

Jürgen Moßgraber 氏が公開している Driven by Moss パッケージに感謝します。このパッケージを利用して Bitwig とのやり取りを行っています。