mplus-mcp

Mplus를 구동하는 MCP 서버입니다: 데이터를 준비하고, 입력 파일을 작성·실행하며, 수백 줄의 고정 폭 텍스트 대신 표 형태로 출력을 읽어 들입니다.

라이선스 실행 파일 및 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으로 처리되지 않는 두 가지 상황을 위해 존재합니다: PATH에 uv가 없는 상태로 시작되는 GUI 클라이언트, 그리고 가상 환경이 동기화 폴더 밖에 있어야 하는 iCloud Drive 내부의 클론입니다.

구성

자동 검색 대상: PATH의 mplus / mpdemo, /Applications/Mplus/mplus, /Applications/MplusDemo/mpdemo, /usr/local/bin/mplus, /opt/mplus/mplus, C:\Program Files\Mplus\Mplus.exe.

.sav 파일을 읽으려면 추가 패키지가 하나 필요합니다: uv sync에 --extra spss를 추가하거나, 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