mplus-mcp

Un servidor MCP que controla Mplus: prepara datos, escribe y ejecuta archivos de entrada, y lee la salida como tablas en lugar de varios cientos de líneas de texto de ancho fijo.

Funciona con el ejecutable con licencia y con Mplus Demo (que limita el modelo a 6 variables dependientes y 2 independientes).

La explicación en chino tradicional está en README.zh-TW.md.

Herramientas

Related MCP server: aigroup-econ-mcp

Instalación

Necesita uv y una instalación de Mplus. La versión demo también funciona.

Claude Code

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

Claude Desktop

Añada a 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"]
    }
  }
}

Si el cliente no encuentra uvx, indique la ruta absoluta (which uvx).

Desde un clon

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

run-server.sh existe para dos situaciones que un simple uv run no maneja: clientes gráficos que se inician sin uv en el PATH, y clones dentro de iCloud Drive, donde el entorno virtual debe vivir fuera de la carpeta sincronizada.

Configuración

Se buscan automáticamente: mplus / mpdemo en el PATH, /Applications/Mplus/mplus, /Applications/MplusDemo/mpdemo, /usr/local/bin/mplus, /opt/mplus/mplus, C:\Program Files\Mplus\Mplus.exe.

Leer archivos .sav requiere un paquete adicional: añada --extra spss a uv sync, o use uvx --from "git+https://github.com/Ian3738/mplus-mcp[spss]" mplus-mcp.

Verifique la configuración pidiendo al modelo que llame a mplus_status.

Cómo transcurre una sesión

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)

Notas sobre el propio Mplus

• Los archivos de datos se resuelven en relación con la carpeta donde se ejecuta el archivo de entrada, por lo que el servidor siempre se ejecuta con el directorio de trabajo establecido en la carpeta del .inp y se refiere a los datos por su nombre de archivo simple. Eso es lo que hace que los nombres de carpeta con espacios funcionen.

• Las líneas de entrada están limitadas a 90 caracteres; run_syntax pliega las más largas.

• Los nombres de variables están limitados a 8 caracteres; data_prepare los renombra y lo informa.

• Una ejecución que falla aún escribe un .out, por lo que el error se analiza y se devuelve con las causas conocidas adjuntas cuando corresponda.

Licencia

MIT