Интеграция MATLAB MCP

Это реализация сервера Model Context Protocol (MCP) для MATLAB. Он позволяет клиентам MCP (таким как агенты LLM или Claude Desktop) взаимодействовать с общей сессией MATLAB с помощью API MATLAB Engine для Python.

Функции

Выполнение кода MATLAB: запуск произвольных фрагментов кода MATLAB с помощью инструмента runMatlabCode .
Извлечение переменных: получение значений переменных из рабочего пространства MATLAB с помощью инструмента getVariable .
Структурированная коммуникация: инструменты возвращают результаты и ошибки в виде структурированного JSON для более удобного программного использования клиентами.
Неблокируемое выполнение: вызовы движка MATLAB выполняются асинхронно с использованием asyncio.to_thread для предотвращения блокировки сервера.
Стандартное ведение журнала: использует стандартный модуль logging Python, выводя данные в stderr для видимости в клиентских журналах.
Общий сеанс: подключается к существующему общему сеансу MATLAB.

ТО, ЧТО ДЕЛАТЬ:

Добавьте инструмент setVariable для записи данных в рабочее пространство MATLAB.
Добавьте инструмент runScript для непосредственного выполнения файлов .m .
Добавьте инструменты для управления рабочим пространством (например, clearWorkspace , getWorkspaceVariables ).
Расширьте вспомогательный модуль matlab_to_python для обработки более сложных типов данных (структуры, массивы ячеек, объекты).
Добавить поддержку взаимодействия с моделями Simulink.

Related MCP server: Modal MCP Toolbox

Требования

Python 3.12 или выше
MATLAB ( рекомендуется R2023a или выше — проверьте совместимость MATLAB Engine API с Python) с установленным MATLAB Engine API для Python.
Пакет numpy Python.

Установка

Клонируйте этот репозиторий:
git clone https://github.com/jigarbhoye04/MatlabMCP.git cd MatlabMCP
Настройте виртуальную среду Python (рекомендуется):
# Install uv if you haven't already: https://github.com/astral-sh/uv uv init uv venv source .venv/bin/activate # On Windows use: .venv\Scripts\activate
Установить зависимости:
uv pip sync
Убедитесь, что MATLAB установлен и MATLAB Engine API для Python настроен для вашей среды Python. См. документацию MATLAB .
Запустите MATLAB и поделитесь его движком: выполните следующую команду в командном окне MATLAB:
matlab.engine.shareEngine
Вы можете проверить, что он общий, запустив matlab.engine.isEngineShared в MATLAB (он должен вернуть true или 1 ). Серверу MCP нужен этот общий движок для подключения.

Конфигурация (для Claude Desktop)

Чтобы использовать этот сервер с Claude Desktop:

Перейдите в Claude Desktop -> Настройки -> Разработчик -> Изменить конфигурацию.
Это откроет claude_desktop_config.json . Добавьте или измените раздел mcpServers , чтобы включить конфигурацию MatlabMCP :
{ "mcpServers": { "MatlabMCP": { "command": "C:\\Users\\username\\.local\\bin\\uv.exe", // Path to your uv executable "args": [ "--directory", "C:\\Users\\username\\Desktop\\MatlabMCP\\", // ABSOLUTE path to the cloned repository directory "run", "main.py" ] // Optional: Add environment variables if needed // "env": { // "MY_VAR": "value" // } } // Add other MCP servers here if you have them } }
ВАЖНО: Замените пути C:\\Users\\username\\... на правильные абсолютные пути для вашей системы.
Сохраните файл и перезапустите Claude Desktop .
Ведение журнала: журналы сервера (из модуля logging Python) будут отображаться в файлах журнала MCP Claude Desktop (доступных через tail -f ~/Library/Logs/Claude/mcp-server-MatlabMCP.log на macOS или проверку %APPDATA%\Claude\logs\ на Windows).

Разработка

Структура проекта:

MatlabMCP/ ├── .venv/ # Virtual environment created by uv ├── Docs/ │ └── Images/ │ └── Updates.md # Documentation for updates and changes ├── main.py # The MCP server script ├── pyproject.toml # Project metadata and dependencies ├── README.md # This file └── uv.lock # Lock file for dependencies