gluon/max-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

22 stars 2 forks 품질 75 트렌드 14MIT

Repository Install

MCP 서버 + 최대 채팅에서 Max/MSP 패치를 빌드하고 드라이브합니다. 주식 목표, 외부 없음. 초기 실험 (v0.4).

개요

그것은 테스트 스위트와 함께 작동하고 배, 하지만 그것은 매우 작은 실제 사용 했다: 거친 가장자리를 기대 하 고 변화를 기대. 그것은 in-Max 채팅을 통해서 주로 운동되었습니다; 외부 MCP 서버는 동일한 엔진을 실행하고 시험을 통과하고 그러나 약간 살아있는 사용을 보았습니다. 버그 보고서 및 피드백은 매우 환영합니다. MCP 클라이언트 (Claude Desktop, Claude Code, MCP Inspector, ...)에서 자연 언어로 Max / MSP 패치를 구축하고 드라이브하십시오. 에이전트는 개체를 생성, 그들을 와이어, 메시지를 설정, toggles 오디오, 그것이 편집하기 전에 실제로 존재하는 것을 볼 수, 그래서 그것은 객체 서명을 추측. 순수한 최대 메커니즘 - 제 3 자 외장, mxj 없음, 릴레이 daemon 없음 : - 패치는 [thispatcher] 스크립트를 사용합니다 (script newdefault, script connect, script split, script delete, script send). - 패치는 공식 Max JS API (boxtext, patchcords)를 통해 패치를 걸고 JSON으로 돌려줍니다.

개요(AI 번역)

Early experiment — v0.4, 첫 번째 공개 테스트, 완제품이 아닙니다. 그것은 테스트 스위트와 함께 작동하고 배, 하지만 그것은 매우 작은 실제 사용 했다: 거친 가장자리를 기대하고, 변화하는 것을 예상하십시오. 그것은 주로 운동하고있다 in-Max 채팅을 통해; 외부 MCP 서버는 동일한 엔진을 실행하고 통과합니다 시험은 그러나 약간 살아있는 사용을 보았습니다. 버그 보고서 및 피드백은 매우 환영합니다.

자연 언어로 Max/MSP 패치 구축 및 구동 MCP 클라이언트 (Claude Desktop, Claude Code, MCP Inspector, …) ** 또는 Max 자체에 살고있는 채팅 창에서 **. 대리인은 목표를 창조합니다, 그(것)들을, 설정 메시지 내용, toggles 오디오,reads live patch back 실제로 그것을 편집하기 전에, 그리고 grounds 자체에 공식 객체 참조 그래서 객체 서명을 중지합니다.

순수한 최대 메커니즘 - 제 3 자 외장, 없음 mxj, 릴레이 데몬 없음 :

-Writing 패치 사용 [thispatcher] 스크립트 (script newdefault], script connect, script disconnect], script delete], script send]). -Reading 패치는 [v8]]를 사용합니다. Patcher를 걷는 JavaScript 객체

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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

GitHub에서 전체 README 보기

설치

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" }
    }
  }
}