自然言語を使用してClaudeコードでMax/MSPパッチを制御します。

概要

MaxMCP は、MCP (Model Context Protocol) サーバーとして動作する Max/MSP のネイティブ C++ 外部オブジェクトです。 Claude Code は、自然言語コマンドで Max/MSP のパッチを制御し、ユーザから必要なゼロ構成で制御できます。

主な特長

• ✅ゼロ設定:パッチに[[maxmcp]]を置きます
• ✅ 自動パッチ検出: 自動生成パッチID
• ✅自然言語制御:「440Hz発振器を追加してパッチを合成」
• ✅マルチパッチサポート: 複数のパッチを同時に制御
• ✅完全なMCPツールセット:包括的なパッチコントロールのための30ツール
• ✅ 自動クリーンアップ: パッチクローズのライフサイクル管理

アーキテクチャ

部品:

• maxmcp.mxo:2つのモードの単一の統一された外面:
• [@mode agent:WebSocketサーバー、MCPプロトコルハンドラ(1 / Maxインスタンス)
• [@mode patch: パッチ登録(1つの制御可能なパッチ、デフォルト)
• Bridge: stdio ↔ WebSocket 翻訳者 (Node.js は自動的に起動)

テックスタック

-言語:C/C++ (最大SDK v8.2.0)

• 建物システム:CMake 3.19+ -アーキテクチュア: arm64(Apple Silicon Native)

MaxMCP - Native MCP Server for Max/MSP

Control your Max/MSP patches with Claude Code using natural language.

Overview

MaxMCP is a native C++ external object for Max/MSP that acts as an MCP (Model Context Protocol) server. It enables Claude Code to control Max/MSP patches through natural language commands, with zero configuration required from users.

Key Features

• ✅ Zero configuration: Just place [maxmcp] in your patch
• ✅ Automatic patch detection: Auto-generated patch IDs
• ✅ Natural language control: “Add a 440Hz oscillator to synth patch”
• ✅ Multi-patch support: Control multiple patches simultaneously
• ✅ Complete MCP toolset: 30 tools for comprehensive patch control
• ✅ Auto-cleanup: Lifecycle management on patch close

Architecture

Claude Code (MCP Client)
    ↕ stdio (JSON-RPC)
Node.js Bridge (websocket-mcp-bridge.js)
    ↕ WebSocket
[maxmcp] C++ External Object
    ↕ Max API
Max/MSP Patches

Components:

• maxmcp.mxo: Single unified external with two modes:
  • @mode agent: WebSocket server, MCP protocol handler (1 per Max instance)
  • @mode patch: Patch registration (1 per controllable patch, default)
• Bridge: stdio ↔ WebSocket translator (Node.js, launched automatically)

Tech Stack

• Language: C/C++ (Max SDK v8.2.0)
• Build System: CMake 3.19+
• Architecture: arm64 (Apple Silicon native)
• MCP Protocol: stdio-based JSON-RPC
• JSON Library: nlohmann/json 3.11.0+
• WebSocket: libwebsockets (installed via Homebrew, bundled into .mxo at build time)
• TLS: OpenSSL 3.x (installed via Homebrew, bundled into .mxo at build time)
• Code Signing: Ad-hoc signature (auto-applied)
• Distribution: Max Package

Installation

Option 1: Max Package Manager (Coming Soon)

1. Open Max/MSP
2. File → Show Package Manager
3. Search “MaxMCP”
4. Click Install

Option 2: Manual Install

1. Download latest release
2. Extract to ~/Documents/Max 9/Packages/
3. Restart Max

Option 3: Build from Source (Development Setup)

Use this path if you’re cloning the repository and want to build the external yourself.

1. Clone the repo

   git clone https://github.com/signalcompose/MaxMCP.git
   cd MaxMCP
   

2. Install prerequisites

   brew install cmake nlohmann-json libwebsockets openssl
   

   • Requires macOS 13+, Xcode Command Line Tools, Max 9.1+, Node.js 18+ with npm.
3. Fetch the Max SDK with submodules

   git clone --branch v8.2.0 https://github.com/Cycling74/max-sdk.git --recursive max-sdk
   

   The --recursive flag is critical; without it max-pretarget.cmake is missing. v8.2.0 is pinned because newer max-sdk no longer ships the max-sdk-base submodule (it switched to CMake FetchContent).
4. Install bridge dependencies