MaxMSP MCP Server

Content

MaxMSP MCP Server is a source-install Model Context Protocol server for Max, Max/MSP, and Jitter patch workflows. It connects a Python MCP server to a Socket.IO bridge running inside Max so Claude can inspect patch contents, explain objects, create objects, remove objects, connect and disconnect objects, set attributes, update message boxes, set number values, and send messages or bangs to named objects.

The project includes a bundled Max bridge patch and JavaScript helpers, a Python MCP server, generated Max object documentation, and an installer that can add the server to supported MCP clients. It is a third-party implementation and is not made by Cycling '74.

Source Review

• https://github.com/tiianhk/MaxMSP-MCP-Server
• https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/README.md
• https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/server.py
• https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/install.py
• https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/requirements.txt
• https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/MaxMSP_Agent/max_mcp.js
• https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/MaxMSP_Agent/max_mcp_node.js
• https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/MaxMSP_Agent/package.json
• https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/LICENSE

These sources were reviewed on 2026-06-06. Prefer the live repository, README, Python server, installer, dependency manifests, Max-side JavaScript bridge files, and license file for current setup requirements, tool behavior, bridge behavior, dependencies, and licensing.

Features

• Source-install Python MCP server using FastMCP and python-socketio.
• Local Socket.IO bridge between the MCP server and a Max patch.
• Tools to add and remove Max objects, connect and disconnect objects, set attributes, set message text, set number values, and send messages or bangs.
• Tools to inspect objects in the current patch, inspect selected objects, read object attributes, and find an avoid-rectangle position for new objects.
• Bundled MaxMSP_Agent demo patch and Max JavaScript bridge files.
• Bundled Max object documentation data used to help Claude explain and generate patch elements.
• Installer support for Claude, Cursor, and VS Code style MCP configuration files.
• MIT license.

Installation

Clone the project and install its Python dependencies:

git clone https://github.com/tiianhk/MaxMSP-MCP-Server.git
cd MaxMSP-MCP-Server
uv venv
uv pip install -r requirements.txt

Configure your MCP client to launch the checked-out server:

{
  "mcpServers": {
    "MaxMSPMCP": {
      "command": "mcp",
      "args": ["run", "<path-to-MaxMSP-MCP-Server/server.py>"]
    }
  }
}

Open a copy of the patch in Max, install the MaxMSP_Agent dependencies as documented upstream, start the bridge inside Max, and then connect Claude to the MCP server.

Use Cases

• Ask Claude to explain the objects, connections, and signal flow in an approved Max patch.
• Generate a simple synthesizer, effect, controller, or Jitter patch structure from natural-language instructions.
• Debug a patch by inspecting selected objects and their attributes.
• Add comments, messages, number boxes, or patch objects while iterating on a teaching sketch.
• Prototype Max/MSP ideas with Claude while keeping a human in control of listening, testing, and saving.
• Use object documentation context to choose valid Max objects and arguments.

Safety and Privacy

MaxMSP MCP Server is write-capable creative tooling. Run it on copies or versioned patches first, especially for performance rigs, installations, class materials, or paid client work. Claude can request object creation, deletion, connection changes, attribute updates, and message/bang dispatches that may produce sound, visuals, CPU spikes, feedback, or patch instability.

The bridge runs through a local Socket.IO server inside Max and can carry patch structure plus edit commands. Keep it on a trusted local machine, avoid exposing it to networks you do not control, and stop the bridge when you are done. Review Python and npm dependencies before installing them, and inspect any MCP client config generated by the installer before committing or sharing files.

Patch object names, comments, arguments, selected objects, subpatch structure, and documentation-assisted prompts can reveal creative or commercial project details. Avoid sending unreleased compositions, show-control logic, proprietary patches, or private notes to a model session unless that use is approved.

Duplicate Check

No MaxMSP MCP Server, Max/MSP MCP, Jitter MCP, or tiianhk/MaxMSP-MCP-Server entry was found in content/mcp, content/agents, content/guides, or content/skills. This entry is scoped to the third-party source-install Max/MSP MCP server and does not duplicate general creative-coding or audio-production resources.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationgithub.com
• Submitted by oktofeesh12026-06-06