MATLAB MCP Core Server

официальный

Запускайте MATLAB® с помощью AI-приложений, используя официальный MATLAB MCP Server от MathWorks®.

GitHub
1.2k

Что можно делать с MATLAB Core MCP?

  • Выполнять код MATLAB напрямую — попросите ассистента запустить фрагменты кода с помощью evaluate_matlab_code и вернуть результат.
  • Запускать скрипты и тесты MATLAB — запросите выполнение файлов .m через run_matlab_file или наборы модульных тестов через run_matlab_test_file.
  • Проверять качество кода без его выполнения — поручите ассистенту проанализировать скрипт на наличие ошибок, проблем со стилем и устаревших функций с помощью check_matlab_code.
  • Получать стандарты кодирования MATLAB — обратитесь к ресурсу matlab_coding_guidelines за рекомендациями по именованию, форматированию и производительности.
  • Получать правила для живых скриптов в виде обычного текста — используйте ресурс plain_text_live_code_guidelines при создании живых скриптов, удобных для систем контроля версий.

Документация

MATLAB MCP Server

English • Español • 日本語 • 한국어 • 简体中文

[!WARNING] Начиная с версии 0.11.0, MATLAB MCP Core Server был переименован в MATLAB MCP Server. Чтобы использовать последнюю версию сервера после этого изменения, необходимо обновить настройки.

ИзмененияНеобходимые действия
Имена бинарных файлов
Новый формат: matlab-mcp-server-<os>-<arch>[.exe]
Пример: matlab-mcp-server-windows-x64.exe		Обновите имя бинарного файла в настройках конфигурации вашего ИИ-приложения, обычно это файл .json.
Инструментарий
Обновлен и переименован: MATLAB MCP Core Server Toolbox → MATLAB MCP Server Toolbox		Установите последнюю версию инструментария, выполнив ./matlab-mcp-server --setup-matlab. Инструментарий необходим для подключения к существующим сеансам MATLAB. Подробнее см. matlab-session-mode в разделе Аргументы.
URL репозитория
github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server		Никаких. GitHub перенаправляет автоматически.
MCP Bundle
Обновлен и переименован: matlab-mcp-core-server.mcpb → matlab-mcp-server.mcpb		Если вы использовали MATLAB MCP bundle для установки MCP-сервера в Claude Desktop до версии 0.11.0, сначала удалите сервер, затем загрузите новый matlab-mcp-server.mcpb bundle со страницы Последний релиз и используйте его для переустановки сервера. Подробнее см. раздел Claude Desktop.
Модуль Go
github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server		Если вы используете модуль MATLAB MCP Core Server в проекте Go, обновите имя модуля в go.mod и ваших объявлениях импорта.

Запускайте MATLAB® с помощью ИИ-приложений, используя официальный MATLAB MCP Server от MathWorks®. MATLAB MCP Server позволяет вашим ИИ-приложениям:

  • Запускать и завершать работу MATLAB.
  • Писать и выполнять код MATLAB.
  • Оценивать ваш код MATLAB на стиль и корректность.

Чтобы помочь вашему агенту в использовании MATLAB и Simulink, вы можете применять навыки из MATLAB Agentic Toolkit (GitHub) и Simulink Agentic Toolkit (GitHub), которые также могут установить этот MCP-сервер для вас.

Содержание

Настройка

  1. Установите MATLAB (MathWorks) R2021a или более поздней версии и добавьте его в системный PATH. MATLAB MCP Server поддерживает выпуски MATLAB за последние пять лет.

  2. Сервер поддерживает любые ИИ-приложения, использующие Model Context Protocol. Чтобы настроить MATLAB MCP Server для Claude Desktop, перейдите к инструкциям для Claude Desktop. Чтобы настроить сервер для других приложений, следуйте этим инструкциям:

    • Для Windows или Linux Загрузите последний релиз. (В качестве альтернативы вы можете собрать из исходного кода: установите Go и соберите бинарный файл с помощью go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest).

    • Для macOS сначала загрузите последний релиз, выполнив следующую команду в терминале:

      • Для процессоров Apple silicon выполните: 
        curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-arm64
      • Для процессоров Intel выполните: 
        curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-x64

      Затем предоставьте загруженному бинарному файлу права на выполнение, чтобы можно было запустить MATLAB MCP Server:

      chmod +x ~/Downloads/matlab-mcp-server

  3. Добавьте MATLAB MCP Server в ваше ИИ-приложение. Инструкции по добавлению MCP-серверов можно найти в документации вашего ИИ-приложения. Примеры инструкций по использованию Claude Code®, Claude Desktop® и GitHub Copilot в Visual Studio® Code см. ниже. Обратите внимание, что вы можете настроить сервер, указав необязательные Аргументы.

Claude Code

В терминале выполните следующую команду, не забыв указать полный путь к бинарному файлу сервера, полученному при настройке:

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary

Вы можете настроить сервер, указав необязательные Аргументы. Обратите внимание на разделитель -- между опциями Claude Code и аргументами сервера:

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

Подробнее о добавлении MCP-серверов в Claude Code см. Добавление локального сервера stdio (Claude Code). Чтобы позже удалить сервер, выполните:

claude mcp remove matlab

Claude Desktop

Вы устанавливаете MATLAB MCP Server в Claude Desktop с помощью MATLAB MCP Server bundle.

  1. Установите расширение Filesystem в Claude Desktop, чтобы позволить Claude читать и записывать файлы в вашей системе. В Claude Desktop нажмите Settings > Extensions > Browse extensions. Найдите расширение Filesystem, разработанное Anthropic, и нажмите Install. Укажите папки, к которым вы хотите разрешить доступ MCP-серверу, затем переключите кнопку Disabled на Enable, чтобы включить расширение Filesystem.

  2. Загрузите MATLAB MCP Server bundle matlab-mcp-server.mcpb со страницы Последний релиз.

  3. Чтобы установить MATLAB MCP Server bundle как расширение рабочего стола, дважды щелкните загруженный файл matlab-mcp-server.mcpb и нажмите Install в Claude Desktop. (В качестве альтернативы перейдите в Claude в File menu > Settings > Extensions > Advanced Settings > Install Extension и выберите файл matlab-mcp-server.mcpb. Нажмите Install).

Чтобы настроить поведение MATLAB MCP Server, перейдите в Settings > Extensions > Configure, где вы можете изменить Аргументы сервера.

GitHub Copilot в Visual Studio Code

В рабочей области VS Code создайте файл с именем .vscode/mcp.json. Вставьте следующий JSON, не забыв указать полный путь к бинарному файлу сервера, полученному при настройке, а также любые Аргументы. Затем сохраните файл. (Обратите внимание, что в Windows ваши пути требуют дополнительных слешей в качестве escape-символов).

{
    "servers": {
        "matlab": {
            "type": "stdio",
            "command": "C:\\fullpath\\to\\matlab-mcp-server-windows-x64.exe",
            "args": []
        }
    }
}

Дополнительные сведения об использовании MCP-серверов в VS Code см. в разделе Добавление и управление MCP-серверами в VS Code (VS Code).

Codex

В терминале выполните следующую команду, не забыв указать полный путь к бинарному файлу сервера, полученному при настройке:

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary

Вы можете настроить сервер, указав необязательные Аргументы. Например:

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

[!NOTE] Пользователи Windows: Codex не передает переменную окружения WINDIR, которая необходима для запуска MATLAB и Simulink (см. #32).

Чтобы добавить переменную, откройте файл конфигурации Codex по адресу C:\Users\<username>\.codex\config.toml и добавьте env_vars = ["WINDIR"] в раздел [mcp_servers.matlab]:

[mcp_servers.matlab]
command = 'C:\fullpath\to\matlab-mcp-server-windows-x64.exe'
args = []
env_vars = ["WINDIR"]

Аргументы

Настройте поведение сервера, указав аргументы одним из следующих способов:

  • Вставьте аргументы в настройки конфигурации вашего ИИ-приложения (обычно это файл .json).
  • Введите аргументы как флаги интерфейса командной строки (CLI) при запуске сервера.
  • Используйте переменные окружения, указанные либо в CLI, либо в настройках конфигурации приложения. Чтобы получить имя переменной окружения из флага CLI, добавьте префикс MW_MCP_SERVER_, преобразуйте в верхний регистр и замените дефисы (-) на подчеркивания (_). Например, аргумент --matlab-root становится переменной окружения MW_MCP_SERVER_MATLAB_ROOT. Флаги CLI имеют приоритет над переменными окружения, если используются оба. | Аргумент | Описание | Пример | | ------------- | ------------- | ------------- | | help | Отображает справочную информацию по всем аргументам. | --help | | version | Отображает версию MATLAB MCP Server. | --version | | matlab-root | Полный путь, указывающий, какой MATLAB следует запустить. Не включайте /bin в путь. По умолчанию сервер пытается найти первый MATLAB в системной переменной PATH. | Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a

    Linux/macOS: --matlab-root=/home/usr/MATLAB/R2026a

    В качестве переменной окружения: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a | | initialize-matlab-on-startup | Чтобы инициализировать MATLAB сразу при запуске сервера, установите этот аргумент в true. По умолчанию MATLAB запускается только при первом вызове инструмента. | --initialize-matlab-on-startup=true | | initial-working-folder | Укажите папку, в которой запускается MATLAB. Если значение не указано, MATLAB запускается по пути первого Root (MCP) вашего AI-приложения. Если корень не задан, MATLAB запускается в следующих расположениях:
    • Linux: /home/username
    • Windows: C:\Users\username\Documents
    • Mac: /Users/username/Documents
    | Windows: --initial-working-folder=C:\\Users\\username\\MyProject

    Linux/macOS: --initial-working-folder=/Users/username/MyProject | | matlab-display-mode | Укажите, показывать ли рабочий стол MATLAB. Используйте режим desktop (по умолчанию), чтобы отображать рабочий стол MATLAB. Используйте режим nodesktop, чтобы использовать MATLAB только из вашего AI-приложения, без рабочего стола MATLAB. Обратите внимание, что в режиме nodesktop команды, требующие графического интерфейса (такие как edit, open, open_system, uifigure и appdesigner), по-прежнему будут открывать окна MATLAB на вашем рабочем столе. | --matlab-display-mode=nodesktop | | matlab-session-mode | Укажите, запускает ли MCP-сервер новый сеанс MATLAB или подключается к существующему сеансу MATLAB (поддерживается для MATLAB R2023a и новее). По умолчанию используется режим auto.

    Режим new: MCP-сервер запускает новый сеанс MATLAB.

    Режим auto (по умолчанию): Сервер пытается подключиться к существующему сеансу MATLAB, который вы должны были настроить для режима existing, следуя инструкциям ниже. Если серверу не удается найти существующий сеанс MATLAB, он запускает новый.

    Режим existing: Сервер пытается подключиться к существующему сеансу MATLAB. Перед использованием этого режима необходимо настроить сеанс MATLAB, выполнив следующие шаги:

    1. Если вы используете режим existing впервые, выполните ./matlab-mcp-server --setup-matlab.

      Эта команда устанавливает дополнение MATLAB MCP Server Toolbox в MATLAB. Вы можете настроить команду с помощью других аргументов из этой таблицы. Например, чтобы указать, какой MATLAB использовать для установки toolbox, можно применить ./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a.

      Для Claude Desktop необходимо загрузить бинарный файл MATLAB MCP Server, следуя инструкциям в разделе Setup, прежде чем выполнять ./matlab-mcp-server --setup-matlab.

    2. В командном окне запущенного сеанса MATLAB выполните shareMATLABSession(). MCP-сервер подключится к этому MATLAB при запуске сервера с параметром --matlab-session-mode=existing или --matlab-session-mode=auto. Если запущено несколько сеансов MATLAB, сервер подключается к тому сеансу, в котором вы последним выполнили команду shareMATLABSession().

      В качестве альтернативы ручному выполнению shareMATLABSession() вы можете добавить эту команду в свой Startup Script (MathWorks) для MATLAB.
    | --matlab-session-mode=existing | | extension-file | Чтобы использовать пользовательские инструменты MCP, укажите путь к JSON-файлу, определяющему ваши инструменты. Можно также использовать несколько файлов расширений. Подробнее об использовании пользовательских инструментов см. в разделе Use Custom Tools with the MATLAB MCP Server. |

    Windows: --extension-file=C:\\Users\\name\\my-tools.json

    Linux/macOS: --extension-file=/path/to/my-tools.json

    Использование нескольких файлов расширений:

    Windows:--extension-file=C:\\path\\to\\tools-1.json --extension-file=C:\\path\\to\\tools-2.json

    Linux/macOS:--extension-file=/path/to/tools1.json --extension-file=/path/to/tools2.json

    Использование переменных окружения:

    Windows: MW_MCP_SERVER_EXTENSION_FILE=C:\Users\name\tools1.json;C:\Users\name\tools2.json

    Linux/macOS: MW_MCP_SERVER_EXTENSION_FILE=/path/to/tools1.json:/path/to/tools2.json | | log-folder | Укажите папку, в которой MCP-сервер будет хранить файлы журналов. Если не указано, сервер использует временную папку вашей операционной системы по умолчанию. | Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp

    Linux/macOS: --log-folder=/tmp/my-logs | | log-level | Уровни ведения журнала MCP-сервера. Допустимые значения в порядке убывания детализации: debug, info, warn и error. | --log-level=debug | | disable-telemetry | Чтобы отключить сбор анонимизированных данных, установите этот аргумент в true. Подробнее см. в разделе Data Collection. | --disable-telemetry=true |

Инструменты

  1. detect_matlab_toolboxes

    • Возвращает информацию об установленном MATLAB и toolbox, включая номера версий.

  2. check_matlab_code

    • Выполняет статический анализ кода скрипта MATLAB. Возвращает предупреждения о стиле кодирования, потенциальных ошибках, устаревших функциях, проблемах производительности и нарушениях лучших практик. Это неразрушающая операция только для чтения, которая помогает выявить проблемы качества кода без выполнения скрипта.
    • Входные данные:
      • script_path (строка): Абсолютный путь к файлу скрипта MATLAB для анализа. Должен быть допустимым файлом .m. Файл не изменяется в процессе анализа. Пример: C:\Users\username\matlab\myFunction.m или /home/user/scripts/analysis.m.

  3. evaluate_matlab_code

    • Вычисляет строку кода MATLAB и возвращает результат.
    • Входные данные:
      • code (строка): Код MATLAB для вычисления.
      • project_path (строка): Абсолютный путь к директории вашего проекта. MATLAB устанавливает эту директорию в качестве текущей рабочей папки. Пример: C:\Users\username\matlab-project или /home/user/research.

  4. run_matlab_file

    • Выполняет скрипт MATLAB и возвращает результат. Скрипт должен быть допустимым файлом .m file.
    • Входные данные:
      • script_path (строка): Абсолютный путь к файлу скрипта MATLAB для выполнения. Должен быть допустимым файлом .m. Пример: C:\Users\username\projects\analysis.m или /home/user/matlab/simulation.m.

  5. run_matlab_test_file

    • Выполняет тестовый скрипт MATLAB и возвращает подробные результаты тестирования. Разработан специально для файлов модульных тестов MATLAB, которые следуют соглашениям среды тестирования MATLAB.
    • Входные данные:
      • script_path (строка): Абсолютный путь к файлу тестового скрипта MATLAB. Должен быть допустимым файлом .m, содержащим модульные тесты MATLAB. Пример: C:\Users\username\tests\testMyFunction.m или /home/user/matlab/tests/test_analysis.m.

Ресурсы

MCP-сервер предоставляет Resources (MCP), чтобы помочь вашему AI-приложению писать код MATLAB. Инструкции по использованию этого ресурса см. в документации вашего AI-приложения, объясняющей, как использовать ресурсы.

  1. matlab_coding_guidelines

    • Предоставляет всесторонние стандарты кодирования MATLAB для улучшения читаемости, сопровождаемости и совместной работы над кодом. Рекомендации охватывают соглашения об именовании, форматирование, комментирование, оптимизацию производительности и обработку ошибок.
    • URI: guidelines://coding
    • MIME-тип: text/markdown
    • Источник: MATLAB Coding Standards (GitHub)

  2. plain_text_live_code_guidelines

    • Предоставляет правила и рекомендации по созданию живых скриптов с использованием формата файлов Live Code .m в виде простого текста, подходящего для контроля версий и разработки с помощью ИИ. Обратите внимание, что для запуска живых скриптов в виде простого текста требуется MATLAB R2025a или новее. Подробнее см. в разделе Live Code File Format (MathWorks).
    • URI: guidelines://plain-text-live-code
    • MIME-тип: text/markdown
    • Источник: Plain Text Live Code Generation (GitHub)

Сбор данных

MATLAB MCP Server может собирать полностью анонимизированную информацию об использовании сервера и отправлять ее в MathWorks. Этот сбор данных помогает MathWorks улучшать продукты и включен по умолчанию. Чтобы отказаться от сбора данных, установите аргумент --disable-telemetry в true.

Вопросы безопасности

При использовании MATLAB MCP Server необходимо тщательно проверять и подтверждать все вызовы инструментов перед их выполнением. Всегда держите человека в курсе для важных действий и приступайте к выполнению только тогда, когда уверены, что вызов сделает именно то, что вы ожидаете. Для получения дополнительной информации см. User Interaction Model (MCP) и Security Considerations (MCP).

Лицензирование и использование

Лицензия доступна в файле LICENSE.md в этом репозитории GitHub.

MCP-серверы разрешается использовать с MATLAB только в соответствии с Лицензионным соглашением на программное обеспечение MathWorks, и они не должны использоваться совместно несколькими пользователями. Обратитесь в MathWorks, если вам требуется поддержка общего или централизованного использования сервера.

Обращение в службу поддержки

MathWorks призывает вас использовать этот репозиторий и оставлять отзывы. Чтобы запросить техническую поддержку или отправить запрос на улучшение, создайте issue на GitHub или обратитесь в MathWorks Technical Support.

Copyright 2025-2026 The MathWorks, Inc.