3ds Max MCP: три сервера и подключение к Claude Code, Codex и Cursor

cl0nazepamm/3dsmax-mcp· Проверено 12.11.2026· 386на GitHub

Подключает агента к открытой сцене 3ds Max: создать и подвинуть объекты, навесить модификаторы, собрать материалы из текстур, поставить свет и ключи анимации, выполнить MAXScript или Python.

3 реализации:

Нативный мост внутри 3ds Max 2023–2027 и 162 инструмента: полигональное моделирование, PBR-материалы, свет Corona и V-Ray, tyFlow, Max Creation Graph, RailClone; ставится установщиком .exe.

Как подключить

Что сделать до подключения

Windows и 3ds Max с 2023 по 2027

Закрыть 3ds Max и клиенты, запустить 3dsmax-mcp-1.7.8-Setup.exe и отметить клиенты: в установщике уже есть Python, мосты и скилл

Из исходников: Python 3.12+, uv и Git, затем uv sync и uv run python install.py

Открыть 3ds Max и перезапустить клиент

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio 3ds_max \
  -- uv run --directory '<путь к 3dsmax-mcp>' 3dsmax-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.3ds_max]
command = "uv"
args = ["run", "--directory", "<путь к 3dsmax-mcp>", "3dsmax-mcp"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "3ds_max": {
      "command": "uv",
      "args": ["run", "--directory", "<путь к 3dsmax-mcp>", "3dsmax-mcp"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "3ds_max": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "<путь к 3dsmax-mcp>", "3dsmax-mcp"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "3ds_max": {
      "command": "uv",
      "args": ["run", "--directory", "<путь к 3dsmax-mcp>", "3dsmax-mcp"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "3ds_max": {
      "command": "uv",
      "args": ["run", "--directory", "<путь к 3dsmax-mcp>", "3dsmax-mcp"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "3ds_max": {
        "type": "local",
        "command": ["uv", "run", "--directory", "<путь к 3dsmax-mcp>", "3dsmax-mcp"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "3ds_max": {
      "command": "uv",
      "args": ["run", "--directory", "<путь к 3dsmax-mcp>", "3dsmax-mcp"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "3ds_max": {
      "command": "uv",
      "args": ["run", "--directory", "<путь к 3dsmax-mcp>", "3dsmax-mcp"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_bridge_statusпроверяет, отвечает ли 3ds Max

get_session_contextсобирает сводку сцены и выделения

query_sceneищет объекты в сцене

create_objectсоздаёт геометрию

transform_objectдвигает, вращает, масштабирует

clone_objectsделает копии и инстансы

add_modifierдобавляет модификатор

create_meshстроит полигональный каркас

mesh_editправит вершины, рёбра, грани

boolean_operationвыполняет булевы операции

create_material_from_texturesсобирает PBR-материал из текстур

assign_materialсоздаёт и назначает материал

smart_importимпортирует папку моделей с текстурами

merge_from_fileвставляет объекты из другого .max

create_lightsставит свет и окружение

keyframe_tracksправит ключи анимации

capture_viewportснимает вьюпорт

render_sceneрендерит текущий вид

create_tyflowсоздаёт систему частиц tyFlow

execute_maxscriptвыполняет MAXScript

Показано 20 из 162.

25 базовых инструментов: сцена, объекты, модификаторы, материалы, свет, ключевые кадры, MAXScript и Python; скрипт-слушатель на порту 50007, пакет 3dsmax-mcp в PyPI.

Как подключить

Что сделать до подключения

Windows, Python 3.10 или новее, uv

3ds Max с Python 3: 2022 и новее, лучше 2024+

Скопировать startup_mcp_listener.ms в C:\Users\<пользователь>\AppData\Local\Autodesk\3dsMax\<версия>\ENU\scripts\startup\ или запустить его через Scripting → Run Script

В MAXScript Listener должна появиться строка «[3dsMaxMCP] MCP Socket Server …»

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-3dsmaxmcp \
  -- uvx 3dsmax-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-3dsmaxmcp]
command = "uvx"
args = ["3dsmax-mcp"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-3dsmaxmcp": {
      "command": "uvx",
      "args": ["3dsmax-mcp"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-3dsmaxmcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["3dsmax-mcp"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-3dsmaxmcp": {
      "command": "uvx",
      "args": ["3dsmax-mcp"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-3dsmaxmcp": {
      "command": "uvx",
      "args": ["3dsmax-mcp"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-3dsmaxmcp": {
        "type": "local",
        "command": ["uvx", "3dsmax-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-3dsmaxmcp": {
      "command": "uvx",
      "args": ["3dsmax-mcp"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-3dsmaxmcp": {
      "command": "uvx",
      "args": ["3dsmax-mcp"]
    }
  }
}

Инструменты сервера

new_sceneсоздаёт пустую сцену

open_sceneоткрывает файл сцены

save_sceneсохраняет сцену

get_scene_infoчитает сведения о сцене

get_scene_objectsперечисляет объекты

import_fileимпортирует файл

export_fileэкспортирует сцену

create_objectсоздаёт Box, Sphere, Cylinder

delete_objectудаляет объект

clone_objectклонирует объект

set_object_transformзадаёт положение, поворот, масштаб

set_object_propertyменяет свойство объекта

add_modifierдобавляет модификатор

create_materialсоздаёт материал

assign_materialназначает материал

create_lightставит источник света

set_keyframeставит ключевой кадр

set_time_rangeзадаёт диапазон анимации

execute_maxscriptвыполняет MAXScript

execute_python_scriptвыполняет Python

Показано 20 из 25.

Адаптер экосистемы DCC-MCP: 3ds Max регистрируется в общем HTTP-шлюзе на 127.0.0.1:9765, инструменты приходят навыками и подгружаются по мере нужды, Undo и Redo с проверкой каждого шага.

Как подключить

Что сделать до подключения

3ds Max 2017 или новее с Python 3 и pymxs

Поставить пакет: python -m pip install --upgrade dcc-mcp-3dsmax, затем dcc-mcp-3dsmax install --json --yes --dcc-path <папка 3ds Max> --python <python.exe внутри 3ds Max>; другой путь — перетащить .mzp из релиза во вьюпорт

Перезапустить 3ds Max и проверить установку: dcc-mcp-3dsmax verify --json

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http dcc-mcp-3dsmax http://127.0.0.1:9765/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.dcc-mcp-3dsmax]
url = "http://127.0.0.1:9765/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "dcc-mcp-3dsmax": {
      "url": "http://127.0.0.1:9765/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "dcc-mcp-3dsmax": {
      "type": "http",
      "url": "http://127.0.0.1:9765/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "dcc-mcp-3dsmax": {
      "httpUrl": "http://127.0.0.1:9765/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "dcc-mcp-3dsmax": {
      "httpUrl": "http://127.0.0.1:9765/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "dcc-mcp-3dsmax": {
        "type": "remote",
        "url": "http://127.0.0.1:9765/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://127.0.0.1:9765/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "dcc-mcp-3dsmax": {
      "url": "http://127.0.0.1:9765/mcp"
    }
  }
}

Инструменты сервера

3dsmax-scene__get_scene_infoчитает сведения о сцене

3dsmax-scene__query_sceneищет объекты

3dsmax-scene__create_objectсоздаёт объект

3dsmax-scene__transform_objectдвигает объект

3dsmax-mesh-ops__add_modifierдобавляет модификатор

3dsmax-uv-atlas__unwrap_uvsразворачивает UV

3dsmax-materials__create_pbr_materialсоздаёт PBR-материал

3dsmax-geometry-io__export_fbxвыгружает FBX

3dsmax-render__render_sceneрендерит сцену

3dsmax-rigging__create_bone_nodeсоздаёт кость

3dsmax-validation__run_asset_readiness_checksпроверяет готовность ассета

3dsmax-scripting__execute_maxscriptвыполняет MAXScript

3dsmax-undo__undo_lastотменяет последнюю операцию

Что попросить агента

«Создай простой стол: столешница — плоский Box, четыре ножки тоже Box»Агент пять раз вызовет create_object с размерами и положением каждой детали

«Сделай столешнице коричневый материал под дерево и повесь над столом тёплую лампу»Агент вызовет create_material, assign_material и create_light

«Пусть сфера за 60 кадров переедет из (0,0,0) в (100,0,50) и повернётся на 360°»Агент поставит ключи set_keyframe на кадрах 0 и 60 и задаст диапазон set_time_range

«Собери PBR-материал из текстур в <папка> и назначь его выделенным объектам»3dsmax-mcp вызовет create_material_from_textures и assign_material

«Найди в сценах из <папка> объект <имя> и вставь его в текущую сцену»3dsmax-mcp вызовет search_max_files, inspect_max_file и merge_from_file

Для каких задач

Собрать простую сцену по словам: стол из боксов, свет над ним

Собрать PBR-материал из папки текстур и назначить его объектам

Найти объект в старых файлах .max и вставить его в текущую сцену

Сделать анимацию по ключевым кадрам

Пачкой переименовать объекты, сменить материалы или навесить модификатор

Подготовить ассет к выгрузке: UV, проверки, экспорт в FBX

Ограничения

Все три работают только на Windows; нативный мост 3dsmax-mcp поддерживает лишь 3ds Max 2023–2027

Safe mode в 3dsmax-mcp ловит опасные вызовы MAXScript по подстроке и обходится; удаление, рендер и запись на диск через собственные инструменты он не фильтрует

3dsmax-mcp от 317431629 не обновлялся с марта 2026 года, у него 18 звёзд; он держит одно окно 3ds Max на порту 50007 и обрывает вызов через 60 секунд

dcc-mcp-3dsmax пока с 9 звёздами, его автотесты идут без настоящего 3ds Max

Если не работает

«Не удаётся подключиться к 3ds Max»

Проверьте, что 3ds Max открыт, слушатель запущен и в MAXScript Listener есть его строка, порт 50007 свободен. Если мешает антивирус или файрвол, добавьте исключение для локального соединения.

Вызов обрывается по таймауту

У сервера 317431629 предел 60 секунд. Разбейте сложную операцию на шаги поменьше и не запускайте рендер через инструменты.

3dsmax-mcp отвечает MAX_BUSY

Смотрите на поле request_sent. При false вызов до 3ds Max не дошёл, повторите его позже. При true вызов ещё выполняется в Max и повторять его нельзя: итог покажет max_dialogs с action="inspect".

Скрипт отклонён с UNSAVED_CHANGES

Скрипт открывает или сбрасывает файл, а в сцене есть несохранённые правки. Сохраните сцену или передайте allow_discard=True, если правки не нужны.

dcc-mcp-3dsmax пишет host_not_found или python_not_found

Передайте установщику точные пути --dcc-path к папке 3ds Max и --python к его python.exe.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
3dsmax-mcp	cl0nazepamm	386	локально	не нужен	162	7 ноября 2026
3dsmax-mcp (PyPI)	317431629	18	локально	не нужен	25	12 марта 2026
dcc-mcp-3dsmax	DCC-MCP	9	HTTP	не нужен	13	29 октября 2026

Частые вопросы

Какой из трёх серверов выбрать?

Для работы в 3ds Max 2023–2027 берите 3dsmax-mcp от cl0nazepamm: у него больше всего инструментов и установщик в один клик. Сервер 317431629 проще и ставится одной командой uvx, подходит и для 2022. dcc-mcp-3dsmax нужен, если вы уже держите другие программы в экосистеме DCC-MCP.

Инструментов слишком много для маленькой модели — что делать?

У 3dsmax-mcp есть профиль progressive: клиент видит только list_toolsets, describe_toolset и call_tool, а схемы остальных грузятся по запросу. Выберите его при установке флагом --tool-profile progressive или задайте MCP_TOOL_PROFILE=progressive.

Можно ли управлять несколькими открытыми 3ds Max?

В 3dsmax-mcp каждое окно регистрирует свой канал: при нескольких окнах выполните в нужном команду MCP Claim This Max. Сервер 317431629 работает только с одним окном на 127.0.0.1:50007.

Работает ли с V-Ray и Corona?

3dsmax-mcp ставит свет через Corona, V-Ray, Octane и штатные фотометрические источники. У сервера 317431629 create_material и create_light создают VRayMtl и VRayLight, если плагин установлен.

Как подключить 3ds Max MCP к Codex?

Для 3dsmax-mcp выполните codex mcp add 3dsmax-mcp -- uv run --directory "C:\path\to\3dsmax-mcp" 3dsmax-mcp. Установщик .exe прописывает сервер в выбранные клиенты сам.

Как подключить 3ds Max MCP к Claude Code?

Команда для 3dsmax-mcp: claude mcp add --scope user 3dsmax-mcp -- uv run --directory "C:\path\to\3dsmax-mcp" 3dsmax-mcp. Для сервера 317431629 возьмите вкладку Claude Code в блоке «Как подключить», там запуск через uvx 3dsmax-mcp.

Работает ли сервер из России?

Серверы работают на вашем компьютере рядом с 3ds Max, ключи и зарубежные аккаунты не нужны.

3ds Max MCP: три сервера и подключение к Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы