Управляйте патчами Max/MSP с помощью кода Claude с использованием естественного языка.

Обзор

MaxMCP - это нативный внешний объект C++ для Max/MSP, который действует как сервер MCP (Model Context Protocol). Это позволяет Claude Code управлять патчами Max/MSP с помощью команд естественного языка с нулевой конфигурацией, требуемой от пользователей.

Ключевые особенности

** Нулевая конфигурация**: просто поместите [maxmcp] в патч ** Автоматическое обнаружение патчей**: Автогенерируемые патчи ID

• • • • Естественный языковой контроль**: «Добавить осциллятор 440 Гц в синт-патч» ** Поддержка нескольких пакетов**: Управление несколькими патчами одновременно Полный набор инструментов MCP: 30 инструментов для комплексного управления патчами
• Автоочистка: Управление жизненным циклом на patch close

Архитектура

** Компоненты**: maxmcp.mxo: Единый унифицированный внешний с двумя режимами: @mode agent: сервер WebSocket, обработчик протокола MCP (1 на экземпляр Max) @mode patch: регистрация патчей (1 на контролируемый патч, по умолчанию)

• Bridge: stdio → Переводчик WebSocket (Node.js, запущен автоматически)

Технологический стек

Язык: C/C++ (Max 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