자연적인 언어를 사용하여 Claude Code로 Max/MSP 패치를 제어하십시오.

개요

MaxMCP는 MCP (모델 Context Protocol) 서버 역할을 하는 Max/MSP의 기본 C++ 외부 객체입니다. Claude Code를 사용하여 자연어 명령을 통해 Max/MSP 패치를 제어할 수 있습니다.

키 기능

• ✅ 영 구성: 그냥 배치 [maxmcp] 의 패치
• ✅ ** 자동 패치 감지 ** : 자동 생성 패치 ID
• ✅ **자연 언어 제어 **: “축 패치에 440Hz 진동자를 추가”
• ✅ ** Multi-patch 지원**: 여러 패치를 동시에 제어
• ✅ ** MCP 툴릿 **: 30 종합 패치 컨트롤을위한 도구
• ✅ ** 자동 세척 **: 패치 닫기에 Lifecycle 관리

건축

** 부품 **:

• maxmcp.mxo: 두 가지 모드로 단일 통합 외부:
• @mode agent: WebSocket 서버, MCP 프로토콜 핸들러(최대 인스턴스당 1개)
• @mode patch: 패치 등록 (1 per controllable patch, default) -Bridge: stdio ↔ WebSocket 번역기 (Node.js, 자동으로 시작)

기술 스택

-Language: C/C++ (최대 SDK v8.2.0)

• 빌딩 시스템: CMake 3.19+
• Architecture: arm64 (애플 실리콘 네이티브)

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