MATLAB MCP Core Server

официальный

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

GitHub

1.5k

Попробовать этот MCPСпонсировано

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

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

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

MATLAB MCP Server

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

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

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

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

Настройка

Установите MATLAB (MathWorks) R2021a или более позднюю версию и добавьте его в системный PATH. MATLAB MCP Server поддерживает выпуски MATLAB за последние пять лет.
Сервер поддерживает любое ИИ-приложение, использующее 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
```
Добавьте 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 см. в разделе Add a local stdio server (Claude Code). Чтобы удалить сервер позже, выполните:

claude mcp remove matlab

Claude Desktop

Установите MATLAB MCP Server в Claude Desktop с помощью пакета MATLAB MCP Server.

Установите расширение Filesystem в Claude Desktop, чтобы разрешить Claude читать и записывать файлы в вашей системе. В Claude Desktop нажмите Settings > Extensions > Browse extensions. Найдите расширение Filesystem, разработанное Anthropic, и нажмите Install. Укажите папки, к которым MCP-серверу разрешён доступ, затем переключите кнопку Disabled в положение Enable, чтобы включить расширение Filesystem.
Скачайте пакет MATLAB MCP Server matlab-mcp-server.mcpb со страницы Latest Release.
Чтобы установить пакет MATLAB MCP Server как расширение рабочего стола, дважды щёлкните загруженный файл 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 см. в разделе Add and Manage MCP servers in 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 запускается в пути первого корневого каталога (MCP) вашего ИИ-приложения. Если корневой каталог не определён, 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 только из вашего ИИ-приложения, без рабочего стола 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 для использования этого режима, выполнив следующие действия: Если вы впервые используете режим `existing`, выполните `./matlab-mcp-server --setup-matlab`. Эта команда устанавливает в MATLAB дополнение с именем MATLAB MCP Server Toolbox. Вы можете настроить команду с помощью других аргументов из этой таблицы. Например, чтобы указать, какой MATLAB использовать для установки набора инструментов, вы можете использовать `./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a`. Для Claude Desktop необходимо скачать бинарный файл MATLAB MCP Server, следуя инструкциям в разделе Настройка, перед выполнением `./matlab-mcp-server --setup-matlab`. В окне команд запущенного сеанса MATLAB выполните `shareMATLABSession()`. MCP-сервер подключится к этому MATLAB при запуске сервера с `--matlab-session-mode=existing` или `--matlab-session-mode=auto`. Если у вас запущено несколько сеансов MATLAB, сервер подключается к тому сеансу MATLAB, в котором вы последний раз выполняли команду `shareMATLABSession()`. Вместо ручного выполнения `shareMATLABSession()` вы можете добавить команду в ваш стартовый скрипт MATLAB (MathWorks).	`--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`. По умолчанию используется `info`.	`--log-level=debug`
disable-telemetry	Чтобы отключить сбор анонимных данных, установите этот аргумент в `true`. Подробнее см. в разделе Сбор данных.	`--disable-telemetry=true`

Инструменты

detect_matlab_toolboxes
- Возвращает информацию об установленных MATLAB и наборах инструментов, включая номера версий.
check_matlab_code
- Выполняет статический анализ кода MATLAB-скрипта. Возвращает предупреждения о стиле кодирования, потенциальных ошибках, устаревших функциях, проблемах производительности и нарушениях лучших практик. Эта операция не разрушает данные и доступна только для чтения, помогая выявить проблемы качества кода без выполнения скрипта.
- Входные данные:
  - script_path (строка): абсолютный путь к файлу MATLAB-скрипта для анализа. Должен быть допустимым файлом .m. Файл не изменяется во время анализа. Пример: C:\Users\username\matlab\myFunction.m или /home/user/scripts/analysis.m.
evaluate_matlab_code
- Выполняет оценку строки кода MATLAB и возвращает результат.
- Входные данные:
  - code (строка): код MATLAB для оценки.
  - project_path (строка): абсолютный путь к вашему проекту. MATLAB устанавливает эту директорию как текущую рабочую папку. Пример: C:\Users\username\matlab-project или /home/user/research.
run_matlab_file
- Выполняет MATLAB-скрипт и возвращает результат. Скрипт должен быть допустимым .m file.
- Входные данные:
  - script_path (строка): абсолютный путь к файлу MATLAB-скрипта для выполнения. Должен быть допустимым файлом .m. Пример: C:\Users\username\projects\analysis.m или /home/user/matlab/simulation.m.
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 предоставляет Ресурсы (MCP) для помощи вашему ИИ-приложению в написании кода MATLAB. Чтобы увидеть инструкции по использованию этого ресурса, обратитесь к документации вашего ИИ-приложения, в которой объясняется, как использовать ресурсы.

matlab_coding_guidelines
- Предоставляет всеобъемлющие стандарты кодирования MATLAB для улучшения читаемости, поддерживаемости и совместной работы. Руководства охватывают соглашения об именовании, форматирование, комментарии, оптимизацию производительности и обработку ошибок.
- URI: guidelines://coding
- Тип MIME: text/markdown
- Источник: Стандарты кодирования MATLAB (GitHub)
plain_text_live_code_guidelines
- Предоставляет правила и рекомендации по созданию живых скриптов с использованием текстового формата Live Code .m, подходящего для контроля версий и разработки с помощью ИИ. Обратите внимание: для запуска текстовых живых скриптов требуется MATLAB R2025a или новее. Подробнее см. Формат файла живого кода (MathWorks).
- URI: guidelines://plain-text-live-code
- Тип MIME: text/markdown
- Источник: Создание текстового живого кода (GitHub)

Сбор данных

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

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

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

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

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

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

Связь с поддержкой

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

Авторские права 2025-2026 The MathWorks, Inc.