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 では対応できない 2 つの状況のために存在します。PATH に uv がない状態で起動する GUI クライアントと、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 ファイルを読み取るには追加パッケージが必要です：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