mplus-mcp

MCP-сервер, который управляет Mplus: он подготавливает данные, записывает и запускает входные файлы, а также считывает результаты в виде таблиц вместо нескольких сотен строк текста фиксированной ширины.

Работает с лицензионным исполняемым файлом и с Mplus Demo (который ограничивает модель 6 зависимыми и 2 независимыми переменными).

繁體中文說明請見 README.zh-TW.md。

Инструменты

Related MCP server: aigroup-econ-mcp

Установка

Требуются uv и установка Mplus. Сборка для демо-версии тоже работает.

Claude Code

claude mcp add mplus -- uvx --from git+https://github.com/Ian3738/mplus-mcp mplus-mcp

Claude Desktop

Добавьте в claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "mplus": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Ian3738/mplus-mcp", "mplus-mcp"]
    }
  }
}

Если клиент не может найти uvx, укажите абсолютный путь (which uvx).

Из клона

git clone https://github.com/Ian3738/mplus-mcp
cd mplus-mcp
uv sync
claude mcp add mplus -- "$(pwd)/run-server.sh"

run-server.sh существует для двух ситуаций, с которыми не справляется простой uv run: GUI-клиенты, запускающиеся без uv в PATH, и клоны внутри iCloud Drive, где виртуальное окружение должно находиться вне синхронизируемой папки.

Конфигурация

Автоматически ищутся: mplus / mpdemo в PATH, /Applications/Mplus/mplus, /Applications/MplusDemo/mpdemo, /usr/local/bin/mplus, /opt/mplus/mplus, C:\Program Files\Mplus\Mplus.exe.

Для чтения файлов .sav нужен дополнительный пакет: добавьте --extra spss к uv sync или используйте uvx --from "git+https://github.com/Ian3738/mplus-mcp[spss]" mplus-mcp.

Проверьте настройку, попросив модель вызвать mplus_status.

Как проходит сеанс

data_prepare(path="ses.csv")
  → writes ses.dat, reports that `motivation` became `motivat`, hands back
    NAMES = id sex y1 y2 y3 y4 x1 x2; MISSING = ALL (-999);

build_syntax(model_type="cfa", data_file="ses.dat",
             names="id sex y1-y4 x1 x2",
             factors={"F1": ["y1", "y2", "y3", "y4"]})
  → the input file as text

run_syntax(syntax=..., workdir="/path/holding/ses.dat", name="cfa1")
  → status, fit table, parameter estimates, any warnings, and cfa1.out on disk

compare_fit(out_paths=["cfa1.out", "cfa2.out"], chisq_diff=True)

Заметки о самом Mplus

• Файлы данных разрешаются относительно папки, в которой запускается входной файл, поэтому сервер всегда работает с рабочей директорией, установленной на папку .inp, и ссылается на данные по их короткому имени файла. Именно это позволяет использовать имена папок с пробелами.

• Строки ввода ограничены 90 символами; run_syntax переносит более длинные.

• Имена переменных ограничены 8 символами; data_prepare переименовывает и сообщает об этом.

• Неудачный запуск всё равно записывает .out, поэтому ошибка анализируется и возвращается с известными причинами, где это применимо.

Лицензия

MIT