gluon/max-mcp-server

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

22 stars 2 forks Качество 75 Тренд 14MIT

Создавайте и управляйте патчами Max/MSP с естественного языка — MCP-сервер + in-Max-чат. Запасные объекты, никаких внешних. Ранний эксперимент (v0.4).

Обзор

Он работает и поставляется с тестовым набором, но он имеет очень мало реального использования: ожидайте грубых краев и ожидайте, что все изменится. Он был реализован в основном через чат in-Max; внешний сервер MCP работает на том же движке и проходит тесты, но практически не используется. Отзывы и отзывы приветствуются. Создавайте и управляйте патчами Max/MSP на естественном языке от клиента MCP (Claude Desktop, Claude Code, MCP Inspector, ...). Агент создает объекты, проводит их, устанавливает содержание сообщений, переключает аудио, чтобы увидеть, что на самом деле есть, прежде чем редактировать, и поэтому он перестает угадывать подписи объектов. Механизмы Pure Max — никаких сторонних внешних эффектов, никаких mxj, никаких демонов реле: - патч использует скриптинг [thispatcher] (новый по умолчанию, подключение к скрипту, отключение сценария, удаление сценария, отправка сценария). - патч использует JavaScript-объект [v8], который перемещает патчер через официальный API Max JS (boxtext, patchcords) и возвращает его как JSON.

Обзор (машинный перевод)

Ранний эксперимент — v0.4, первый публичный тест, а не готовый продукт. Он работает и поставляется с тестовым набором, но он имеет очень мало реального использования: Ожидайте грубых краев и ожидайте, что все изменится. В основном он осуществлялся через чат in-Max; внешний сервер MCP запускает тот же движок и проходит Тесты, но видели мало живого использования. Отзывы и отзывы приветствуются.

Создавать и управлять патчами Max/MSP на естественном языке; от клиента MCP (Claude Desktop, Claude Code, MCP Inspector, …) Из окна чата, которое живет внутри самого Макса. Агент создает объекты, Проводит их, устанавливает содержание сообщений, переключает аудио, ** читает живой патч обратно ** Чтобы увидеть, что на самом деле там, прежде чем он отредактирует, и ** заземляет себя на официальное указание объекта**, чтобы перестать угадывать подписи объекта.

Механизмы Pure Max — никаких сторонних внешних эффектов, никаких mxj, никаких демонов реле:

Письмо пластырь использует [thispatcher] скриптинг script newdefault, [Т3], [Т4], [Т5], [Т6]. **Читая ** патч использует [v8] JavaScript объект, который ходит по патчеру

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

maxmsp-mcp

Early experiment — v0.4, a first public test, not a finished product. It works and ships with a test suite, but it has had very little real-world use: expect rough edges, and expect things to change. It has been exercised mostly through the in-Max chat; the external MCP server runs the same engine and passes the tests but has seen little live use. Bug reports and feedback are very welcome.

Build and drive Max/MSP patches in natural language, from an MCP client (Claude Desktop, Claude Code, the MCP Inspector, …) or from a chat window that lives inside Max itself. The agent creates objects, wires them, sets message content, toggles audio, reads the live patch back to see what is actually there before it edits, and grounds itself on the official object reference so it stops guessing object signatures.

Pure Max mechanisms — no third-party externals, no mxj, no relay daemon:

Writing the patch uses [thispatcher] scripting (script newdefault, script connect, script disconnect, script delete, script send).
Reading the patch uses a [v8] JavaScript object that walks the patcher via the official Max JS API (boxtext, patchcords) and returns it as JSON.
Transport to the external server is OSC over UDP between the Python server and a stock [udpreceive] / [udpsend] pair in the host patch. The in-Max chat drives the same plumbing directly from [node.script].

Two ways to use it

Facade	What it is	Runs the LLM via
External MCP server	`maxmsp_mcp.server`, spoken to by Claude Desktop / Claude Code / the Inspector over stdio	your Claude plan / MCP client
In-Max chat	a chat window inside the patch (`[node.script chat.js]` + `[jweb]`), no external client	the Anthropic API (or a local model)

Both facades share the same command vocabulary, the same host patch, and the same patching guide. Build with one, inspect or extend with the other.

Design notes

Stable addressing. Every object the agent creates gets a scripting name. You wire, set and delete by name, so the mapping never drifts when the user edits the patch by hand. In the in-Max chat the model assigns its own readable labels (carrier, pack_main, …) and wires by those.
Single-object delete. script delete removes exactly one object.
Closed loop. The agent dumps the live patch to confirm its own work and to discover objects the user added by hand, instead of building blind.
Machinery stays hidden. Plumbing objects carry mcp_* scripting names and are filtered out of every dump, so the agent only ever sees the musical patch.
Grounded on the docs. A parsed reference database lets the agent look up an object’s real inlets, outlets, arguments and attributes instead of inventing them.

Architecture

Открыть полный README на GitHub

Установка

npx @modelcontextprotocol/inspector \

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "maxmsp": {
      "command": "/absolute/path/to/uv",
      "args": ["--directory", "/absolute/path/to/max-mcp-server",
               "run", "python", "-m", "maxmsp_mcp.server"],
      "env": { "MAX_HOST": "127.0.0.1", "MAX_PORT": "7400", "MAX_RETURN_PORT": "7401" }
    }
  }
}