Интеграция 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: MATLAB MCP Server

Требования

• 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).

Разработка

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

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

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

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

Внося вклад

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

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