MATLAB MCP Server

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

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