ersatzben/maxmsp-mcp

Developer tools

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

172 stars 19 forks Качество 76 Тренд 22MIT

Repository Install

ersatzben/maxmsp-mcp — это кандидат на сервер MCP, импортированный из https://github.com/ersatzben/maxmsp-mcp.

Обзор

ersatzben/maxmsp-mcp — это кандидат на сервер MCP, импортированный из https://github.com/ersatzben/maxmsp-mcp.

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

В этом проекте используется протокол Model Context Protocol (MCP), чтобы LLM могли напрямую понимать и генерировать патчи Max.

Уведомление о форке: Это расширенный форк оригинального MaxMSP-MCP-Server, созданный Хаокунь Тянем и Шуоян Чжэном. Подробности см. в разделе «Благодарности».

Что нового в этой вилке

Этот форк значительно расширяет оригинал новыми инструментами, функциями безопасности и интеграцией Claude Code:

Новые инструменты MCP (+11)

Инструмент	Описание
`create_subpatcher`	Создать новый объект [`p` (субпатчер)
`enter_subpatcher`	Перейти в контекст субпатчера
`exit_subpatcher`	Вернуться к родительскому патчеру
`get_patcher_context`	Получите текущую глубину и навигационный маршрут
`add_subpatcher_io`	Добавить входные/выходные объекты внутри субпатчеров
`get_object_connections`	Запросить все соединения для объекта
`recreate_with_args`	Изменение аргументов по времени создания, сохранение связей
`move_object`	Переместить объект
`autofit_existing`	Применить авто-размер к существующим объектам
`check_signal_safety`	Проанализировать патч на опасные сигнальные паттерны
`encapsulate`	Инкапсулировать выбранные объекты в субпатчер

Функции безопасности и валидации

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

README

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

MaxMSP-MCP Server (Extended Fork)

This project uses the Model Context Protocol (MCP) to let LLMs directly understand and generate Max patches.

Fork Notice: This is an extended fork of the original MaxMSP-MCP-Server by Haokun Tian and Shuoyang Zheng. See Acknowledgements for details.

What’s New in This Fork

This fork significantly extends the original with new tools, safety features, and Claude Code integration:

New MCP Tools (+11)

Tool	Description
`create_subpatcher`	Create a new `p` (subpatcher) object
`enter_subpatcher`	Navigate into a subpatcher context
`exit_subpatcher`	Return to parent patcher
`get_patcher_context`	Get current depth and navigation path
`add_subpatcher_io`	Add inlet/outlet objects inside subpatchers
`get_object_connections`	Query all connections for an object
`recreate_with_args`	Change creation-time arguments, preserving connections
`move_object`	Reposition an object
`autofit_existing`	Apply auto-sizing to existing objects
`check_signal_safety`	Analyze patch for dangerous signal patterns
`encapsulate`	Encapsulate selected objects into a subpatcher

Safety & Validation Features

Float enforcement: Math objects (+, -, *, /, %, pow, scale) and pack/unpack objects require float arguments. Use STRING args to preserve floats (JSON strips .0): ["0", "127", "0", "25."]. Use int_mode=True to explicitly allow integers. Exception: scale with output range ≤ 2 auto-detects float intent.
dial range enforcement: Rejects live.dial (suggests dial with inline attributes); requires @size on dial objects; rejects @size > 255 (unusable UI - use extend=True to bypass)
trigger/t acknowledgment: Requires trigger_rtl=True flag to confirm understanding that outlets fire right-to-left
random acknowledgment: Requires random_bang=True flag to confirm understanding that numbers set range but bangs trigger output
coll embed enforcement: Requires @embed 1 in args to ensure data persists on save
line~ message validation: Rejects messages with odd numeric count (likely malformed target-time pairs)
Object validation: Rejects invalid objects (e.g., times~ → suggests *~)
Argument validation: Enforces minimum arguments for complex objects (e.g., comb~ requires 5 args)
Parameter range checks: Catches common mistakes like svf~ Q >= 1 or onepole~ frequency < 10 Hz
Large patch warnings: Alerts when root patcher exceeds 80 objects
Signal safety analysis: Detects feedback loops, high gain, unsafe comb~ feedback, and missing limiters before dac~

Quality of Life Improvements

Auto-sizing: Objects and comments automatically fit their content
Increased timeouts: Better handling of large patchers (5s vs 2s)

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

Установка

This server does not publish a one-line install command.

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

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

{
  "mcpServers": {
    "maxmsp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/MaxMSP-MCP-Server",
        "run",
        "server.py"
      ]
    }
  }
}