Интеграция 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.

Требования

• Python 3.12 или выше

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

• Пакет numpy Python.

Установка

1. Клонируйте этот репозиторий:

   git clone https://github.com/jigarbhoye04/MatlabMCP.git cd MatlabMCP

2. Настройте виртуальную среду 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

3. Установить зависимости:

   uv pip sync

4. Убедитесь, что MATLAB установлен и MATLAB Engine API для Python настроен для вашей среды Python. См. документацию MATLAB .

5. Запустите MATLAB и поделитесь его движком: выполните следующую команду в командном окне MATLAB:

   matlab.engine.shareEngine

   Вы можете проверить, что он общий, запустив matlab.engine.isEngineShared в MATLAB (он должен вернуть true или 1 ). Серверу MCP нужен этот общий движок для подключения.

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

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

1. Перейдите в Claude Desktop -> Настройки -> Разработчик -> Изменить конфигурацию.

2. Это откроет 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 } }

3. ВАЖНО: Замените пути C:\\Users\\username\\... на правильные абсолютные пути для вашей системы.

4. Сохраните файл и перезапустите Claude Desktop .

5. Ведение журнала: журналы сервера (из модуля logging Python) будут отображаться в файлах журнала MCP Claude Desktop (доступных через tail -f ~/Library/Logs/Claude/mcp-server-MatlabMCP.log на macOS или проверку %APPDATA%\Claude\logs\ на Windows).

Разработка

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

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

Подробную документацию по функциям сервера, его использованию и заметкам по разработке см. в разделе « Обновления ».

Внося вклад

Вклады приветствуются! Если у вас есть предложения или улучшения, смело открывайте issue или отправляйте pull request.

Давайте сделаем это еще лучше вместе!