Max/MSP MCP Server
MCP-сервер для Max/MSP (Cycling '74): AI-агент создаёт и управляет патчами визуального программирования для аудиосинтеза, генеративной музыки и мультимедиа. Используется в IRCAM, академической музыке и экспериментальных перформансах.
# Требуется: Max/MSP 8+ (Cycling '74)
# Установка Python-сервера:
git clone https://github.com/tiianhk/MaxMSP-MCP-Server.git
cd MaxMSP-MCP-Server
pip install -r requirements.txt
# Шаг 2 — открыть Max-патч из репо (mcp_server.maxpat) в Max/MSP
# Claude Desktop — claude_desktop_config.json:
{ "mcpServers": { "maxmsp": { "command": "python", "args": ["/path/to/MaxMSP-MCP-Server/server.py"] } } }
# Claude Code (CLI):
claude mcp add maxmsp -- python /path/to/MaxMSP-MCP-Server/server.py
# OpenCode — ~/.config/opencode/opencode.json:
{ "mcp": { "maxmsp": { "type": "local", "command": ["python", "/path/to/MaxMSP-MCP-Server/server.py"] } } }
Примечание: Расширенная версия от ersatzben и BenCello доступна по ссылке: https://github.com/ersatzben/maxmsp-mcp
MaxMSP-MCP Server
Этот проект использует Протокол Контекста Модели (MCP), чтобы позволить языковым моделям (LLM) напрямую понимать и генерировать патчи Max.
Понимание: LLM объясняет патч Max
Ссылка на видео. Благодарности: объясняемый патч загружен отсюда. Текстовые комментарии в исходном файле удалены.
Генерация: LLM создает FM-синтезатор
Посмотрите полное видео, где можно услышать синтезированные звуки.
Агент LLM имеет доступ к официальной документации каждого объекта, а также к объектам в текущем патче и окнах субпатчей, что помогает при поиске и объяснении объектов, отладке и проверке собственных действий.
Установка
Предварительные требования
- Python 3.8 или новее
- Пакетный менеджер uv
- Max 9 или новее (поскольку некоторые скрипты требуют движок Javascript V8). Мы еще не тестировали его на Max 8 или более ранних версиях Max.
Установка MCP-сервера
- Установите uv:
# На macOS и Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
# На Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
- Клонируйте этот репозиторий и перейдите в его директорию:
git clone https://github.com/tiianhk/MaxMSP-MCP-Server.git
cd MaxMSP-MCP-Server
- Создайте новую среду и установите зависимости Python:
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
- Подключите MCP-сервер к MCP-клиенту (который hosting LLM):
# Claude:
python install.py --client claude
# или Cursor:
python install.py --client cursor
Для использования других клиентов (проверьте список) вам нужно загрузить и вручную добавить путь к файлу конфигурации в это место, а затем подключиться, выполнив python install.py --client {ваше_имя_клиента}.
Установка в патч Max
Используйте или скопируйте файл MaxMSP_Agent/demo.maxpat. На первой вкладке нажмите сообщение script npm version, чтобы проверить, установлен ли npm. Затем нажмите script npm install, чтобы установить необходимые зависимости. Переключитесь на вторую вкладку, чтобы получить доступ к агенту. Нажмите script start, чтобы инициировать связь с Python. После подключения вы сможете взаимодействовать с интерфейсом LLM, чтобы он объяснял, модифицировал или создавал объекты Max в патче.
Отказ от ответственности
Это сторонняя реализация, созданная не компанией Cycling '74.