Skip to content
Back to search

MaxMSP-MCP-Server

MCP (Model Context Protocol) Server for Max (Max/MSP/Jitter)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tiianhk--maxmsp-mcp-server/badge.svg)](/listings/tiianhk--maxmsp-mcp-server)

HTML

<a href="/listings/tiianhk--maxmsp-mcp-server"><img src="/api/listings/tiianhk--maxmsp-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Prerequisites

- Python 3.8 or newer - [uv package manager](https://github.com/astral-sh/uv) - Max 9 or newer (because some of the scripts require the Javascript V8 engine), we have not tested it on Max 8 or earlier versions of Max yet.

Installing the MCP server

1. Install uv:

# On macOS and Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Clone this repository and open its directory:

git clone https://github.com/tiianhk/MaxMSP-MCP-Server.git
cd MaxMSP-MCP-Server

3. Start a new environment and install python dependencies:

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

4. Connect the MCP server to a MCP client (which hosts LLMs):

# Claude:
python install.py --client claude
# or Cursor:
python install.py --client cursor

To use other clients (check the [list](https://modelcontextprotocol.io/clients)), you need to download, mannually add the configuration file path to [here](https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/install.py#L6-L13), and connect by running `python install.py --client {your_client_name}`.

Installing to a Max patch

Use or copy from `MaxMSP_Agent/demo.maxpat`. In the first tab, click the `script npm version` message to verify that [npm](https://github.com/npm/cli) is installed. Then click `script npm install` to install the required dependencies. Switch to the second tab to access the agent. Click `script start` to initiate communication with Python. Once connected, you can interact with the LLM interface to have it explain, modify, or create Max objects within the patch.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 62 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. **Note:** An extended version by ersatzben and BenCello can be found at: [https://github.com/ersatzben/maxmsp-mcp](https://github.com/ersatzben/maxmsp-mcp)
  2. # MaxMSP-MCP Server
  3. This project uses the [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) to let LLMs directly understand and generate Max patches.
  4. ### Understand: LLM Explaining a Max Patch
  5. ![img](./assets/understand.gif)
  6. [Video link](https://www.youtube.com/watch?v=YKXqS66zrec). Acknowledgement: the patch being explained is downloaded from [here](https://github.com/jeffThompson/MaxMSP_TeachingSketches/blob/master/02_MSP/07%20Ring%20Modulation.maxpat). Text comments in the original file are deleted.
  7. ### Generate: LLM Making an FM Synth
  8. ![img](./assets/generate.gif)
  9. Check out the [full video](https://www.youtube.com/watch?v=Ns89YuE5-to) where you can listen to the synthesised sounds.
  10. The LLM agent has access to the official documentation of each object, as well as objects in the current patch and subpatch windows, which helps in retrieving and explaining objects, debugging, and verifying their own actions.
  11. ## Installation
  12. ### Prerequisites
  13. - Python 3.8 or newer
  14. - [uv package manager](https://github.com/astral-sh/uv)
  15. - Max 9 or newer (because some of the scripts require the Javascript V8 engine), we have not tested it on Max 8 or earlier versions of Max yet.
  16. ### Installing the MCP server
  17. 1. Install uv:
  18. ```
  19. # On macOS and Linux:
  20. curl -LsSf https://astral.sh/uv/install.sh | sh
  21. # On Windows:
  22. powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  23. ```
  24. 2. Clone this repository and open its directory:
  25. ```
  26. git clone https://github.com/tiianhk/MaxMSP-MCP-Server.git
  27. cd MaxMSP-MCP-Server
  28. ```
  29. 3. Start a new environment and install python dependencies:
  30. ```
  31. uv venv
  32. source .venv/bin/activate
  33. uv pip install -r requirements.txt
  34. ```
  35. 4. Connect the MCP server to a MCP client (which hosts LLMs):
  36. ```
  37. # Claude:
  38. python install.py --client claude
  39. # or Cursor:
  40. python install.py --client cursor
  41. ```
  42. To use other clients (check the [list](https://modelcontextprotocol.io/clients)), you need to download, mannually add the configuration file path to [here](https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/install.py#L6-L13), and connect by running `python install.py --client {your_client_name}`.
  43. ### Installing to a Max patch
  44. Use or copy from `MaxMSP_Agent/demo.maxpat`. In the first tab, click the `script npm version` message to verify that [npm](https://github.com/npm/cli) is installed. Then click `script npm install` to install the required dependencies. Switch to the second tab to access the agent. Click `script start` to initiate communication with Python. Once connected, you can interact with the LLM interface to have it explain, modify, or create Max objects within the patch.
  45. ## Disclaimer
  46. This is a third party implementation and not made by Cycling '74.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.