MATLAB MCP: как подключить MATLAB к Claude Code, Codex и Cursor

matlab/matlab-mcp-server· Проверено 12.11.2026· 1,8 тыс.на GitHub

Даёт агенту запускать MATLAB: выполнять код и скрипты, гонять юнит-тесты, проверять код через checkcode, читать переменные рабочей области и данные графиков.

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

Готовый бинарник от MathWorks: 5 инструментов, сам запускает MATLAB или подключается к уже открытой сессии; к нему идут правила MATLAB-кода как ресурсы.

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

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

MATLAB R2021a или новее, добавленный в системный PATH

Скачать бинарник для Windows, Linux или macOS со страницы последнего релиза; на macOS дать права chmod +x

Для Claude Desktop — файл matlab-mcp-server.mcpb из релиза и расширение Filesystem; для Claude Code, Copilot CLI и Codex MathWorks советует Agentic Toolkit Installer

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

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

claude mcp add --transport stdio matlab \
  -- '<полный путь к matlab-mcp-server>'

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

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

[mcp_servers.matlab]
command = "<полный путь к matlab-mcp-server>"
args = []

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

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

{
  "mcpServers": {
    "matlab": {
      "command": "<полный путь к matlab-mcp-server>",
      "args": []
    }
  }
}

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

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

{
  "mcpServers": {
    "matlab": {
      "type": "stdio",
      "command": "<полный путь к matlab-mcp-server>",
      "args": []
    }
  }
}

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

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

{
  "mcpServers": {
    "matlab": {
      "command": "<полный путь к matlab-mcp-server>",
      "args": []
    }
  }
}

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

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

{
  "mcpServers": {
    "matlab": {
      "command": "<полный путь к matlab-mcp-server>",
      "args": []
    }
  }
}

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "matlab": {
        "type": "local",
        "command": ["<полный путь к matlab-mcp-server>"]
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "matlab": {
      "command": "<полный путь к matlab-mcp-server>",
      "args": []
    }
  }
}

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

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

{
  "mcpServers": {
    "matlab": {
      "command": "<полный путь к matlab-mcp-server>",
      "args": []
    }
  }
}

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

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

detect_matlab_toolboxesпоказывает версию MATLAB и тулбоксы

check_matlab_codeпроверяет скрипт статическим анализом

evaluate_matlab_codeвыполняет код MATLAB

run_matlab_fileзапускает скрипт .m или .p

run_matlab_test_fileзапускает юнит-тесты

Работает через MATLAB Engine для Python: запускает скрипт по секциям, держит рабочую область между вызовами, отдаёт данные и метаданные графиков.

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

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

MATLAB с MATLAB Engine для Python, Python 3.10 или новее и uv

Склонировать репозиторий и запустить ./install-matlab-mcp.sh: он найдёт MATLAB, соберёт окружение и сгенерирует конфиг

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

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

claude mcp add --env 'MATLAB_PATH=<папка MATLAB, например /Applications/MATLAB_R2024b.app>' --transport stdio matlab-mcp-tools \
  -- '<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server'

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

[mcp_servers.matlab-mcp-tools]
command = "<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server"
args = []

[mcp_servers.matlab-mcp-tools.env]
MATLAB_PATH = "<папка MATLAB, например /Applications/MATLAB_R2024b.app>"

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

{
  "mcpServers": {
    "matlab-mcp-tools": {
      "command": "<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server",
      "args": [],
      "env": {
        "MATLAB_PATH": "<папка MATLAB, например /Applications/MATLAB_R2024b.app>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "matlab-mcp-tools": {
      "type": "stdio",
      "command": "<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server",
      "args": [],
      "env": {
        "MATLAB_PATH": "<папка MATLAB, например /Applications/MATLAB_R2024b.app>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "matlab-mcp-tools": {
      "command": "<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server",
      "args": [],
      "env": {
        "MATLAB_PATH": "<папка MATLAB, например /Applications/MATLAB_R2024b.app>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "matlab-mcp-tools": {
      "command": "<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server",
      "args": [],
      "env": {
        "MATLAB_PATH": "<папка MATLAB, например /Applications/MATLAB_R2024b.app>"
      }
    }
  }
}

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "matlab-mcp-tools": {
        "type": "local",
        "command": ["<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server"],
        "environment": {
          "MATLAB_PATH": "<папка MATLAB, например /Applications/MATLAB_R2024b.app>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "matlab-mcp-tools": {
      "command": "<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server",
      "args": [],
      "env": {
        "MATLAB_PATH": "<папка MATLAB, например /Applications/MATLAB_R2024b.app>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "matlab-mcp-tools": {
      "command": "<путь к matlab-mcp-tools>/.venv/bin/matlab-mcp-server",
      "args": [],
      "env": {
        "MATLAB_PATH": "<папка MATLAB, например /Applications/MATLAB_R2024b.app>"
      }
    }
  }
}

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

execute_scriptвыполняет код или файл

execute_section_by_indexвыполняет секцию по номеру

execute_section_by_titleвыполняет секцию по заголовку

get_script_sectionsвыводит секции скрипта

create_matlab_scriptсоздаёт файл .m

get_workspaceчитает рабочую область

get_variableчитает переменную

list_workspace_variablesфильтрует переменные

get_figure_metadataчитает оси и подписи графика

get_plot_dataотдаёт данные линий графика

analyze_figureготовит график к разбору

matlab_lintпроверяет код через checkcode

Показано 12 из 15.

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

«Напиши функцию для фильтрации сигнала и проверь её на тестовых данных»Агент выполнит код через evaluate_matlab_code и проверит файл через check_matlab_code

«Запусти тесты в <папка>/tests и разбери, что упало»Агент вызовет run_matlab_test_file по файлам тестов

«Какие тулбоксы у меня установлены?»Агент вызовет detect_matlab_toolboxes

«Выполни секцию «Data Generation» из <скрипт>.m и покажи статистику»Вариант neuromechanist вызовет execute_section_by_title и прочитает переменные через get_variable

«Что показывает график, который построил скрипт?»Вариант neuromechanist прочитает оси и подписи через get_figure_metadata, данные через get_plot_data и разберёт картинку через analyze_figure

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

Написать и выполнить код MATLAB и вернуть вывод

Прогнать юнит-тесты и разобрать упавшие

Проверить скрипт на ошибки, устаревшие функции и стиль

Выполнить одну секцию длинного скрипта, не теряя переменные

Прочитать данные и подписи построенного графика

Узнать, какие тулбоксы и какая версия MATLAB стоят

Ограничения

Нужна своя лицензия MATLAB: сервер MathWorks можно использовать только по лицензионному соглашению MathWorks и нельзя делить между несколькими пользователями

Сервер MathWorks по умолчанию отправляет MathWorks обезличенную статистику использования; выключается флагом --disable-telemetry=true

У neuromechanist/matlab-mcp-tools 19 звёзд и последнее обновление в марте 2026 года; MATLAB Engine требует подходящую версию Python: R2024b — 3.11, R2024a — 3.10

Даже в режиме nodesktop команды с интерфейсом (edit, open, uifigure, appdesigner) открывают окна MATLAB на рабочем столе

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

Codex на Windows не запускает MATLAB

Codex не передаёт переменную WINDIR. В C:\Users\<имя>\.codex\config.toml в секцию [mcp_servers.matlab] добавьте env_vars = ["WINDIR"].

MATLAB not found при установке neuromechanist/matlab-mcp-tools

Если MATLAB стоит в нестандартной папке, задайте её: export MATLAB_PATH=<путь к MATLAB>.

Ошибка ENOENT при запуске neuromechanist/matlab-mcp-tools

Клиент запускает другой Python: укажите в command bash с аргументами -c и source ~/.zshrc && <путь>/.venv/bin/matlab-mcp-server.

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

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MATLAB MCP Serverразработчик сервиса	MathWorks	1,8 тыс.	локально	не нужен	5	12 ноября 2026
MATLAB MCP Tool	neuromechanist	19	локально	не нужен	15	2 марта 2026

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

Как подключить сервер к уже открытому MATLAB?

Один раз выполните ./matlab-mcp-server --setup-matlab: команда поставит в MATLAB аддон MATLAB MCP Server Toolbox. Затем в окне команд MATLAB запустите shareMATLABSession(). В режиме auto (по умолчанию) или existing сервер подключится к этой сессии; работает с MATLAB R2023a и новее.

Как указать, какой MATLAB запускать и в какой папке?

Флаг --matlab-root задаёт папку MATLAB без /bin, --initial-working-folder — рабочую папку. Любой флаг можно передать переменной окружения: префикс MW_MCP_SERVER_, верхний регистр и подчёркивания, например MW_MCP_SERVER_MATLAB_ROOT.

Можно ли добавить свои инструменты?

Да: опишите их в JSON-файле и передайте через --extension-file, файлов может быть несколько. Чтобы публиковать функции MATLAB как инструменты на сервере, у MathWorks есть отдельный MCP Framework for MATLAB Production Server.

Чем вариант neuromechanist отличается от сервера MathWorks?

Он запускает скрипт по секциям %%, хранит рабочую область между вызовами и умеет читать переменные и графики: метаданные осей, сырые данные линий. Сервер MathWorks проще: выполняет код и файлы, тесты и checkcode.

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

Оба сервера работают на вашем компьютере с установленным MATLAB; сами серверы внешних аккаунтов не требуют.

MATLAB MCP: как подключить MATLAB к Claude Code, Codex и Cursor

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

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

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

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

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

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

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

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

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

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

Ограничения

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

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

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

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