PLAXIS

▸ v0.3 — 一度セットアップすれば、どこからでも起動

クライアントに依存しない設計です。Codex、Claude Code、Cursor、VS Code/Copilot、その他の準拠したローカル stdio MCP クライアントは、同じプレフィックスなしのサーバーツールに接続します。

クイックスタート

1 — マシンを一度だけセットアップします。

plaxis-mcp.exe setup

プロファイルは %LOCALAPPDATA%\Caros\PLAXIS-MCP\profiles に保存されます（--profile-dir で変更できます）。 今すぐプロファイルを生成してパスワードは後で保存するには、--skip-credentials を追加し、 plaxis-mcp.exe credentials set --profile <profile.toml> を実行してください。

ディレクトリ名は歴史的なものです。最初にサポートされたインストーラーがこの場所に書き込んだため、 credential_target がこの名前から導出されることもあり、そのまま維持されています。

2 — 各ロールをそれぞれ別のプロセスとして実行します。

plaxis-mcp.exe serve --role input
plaxis-mcp.exe serve --role output

--config <profile.toml> でプロファイルを明示的に指定することもでき、同じ意味です。どちらの場合も serve はすべてのエンドポイント設定をプロファイルから、パスワードを Windows Credential Manager から取得します。また、PLAXIS_* エンドポイント環境変数による上書きが存在する場合は起動に失敗するため、クライアントがエンドポイントを気づかれずに変更したり、パスワードを注入したりすることはできません。

3 — クライアントから接続します。 クライアントを参照してください。ホストは起動時に接続しないため、PLAXIS の起動後に connect ツールを一度呼び出してください。

ホストの取得

どちらも同じ setup、serve、credentials、profiles コマンドを公開し、同じプロファイルのバインドと環境変数による上書きの拒否を適用します。そのため、PyPI は実行時のセキュリティ体制が弱いわけではありません。ただし、PyPI 自体のものを除き、独自のサプライチェーン証明は付属しません。また、署名済みバイナリを必須とする組織がデプロイすべきものではありません。

どちらの場合も、ホスト環境に plxscripting をインストールしないでください。

py -3.13 -m pip install .
$env:PLAXIS_ROLE = "input"
$env:PLAXIS_INPUT_HOST = "127.0.0.1"
$env:PLAXIS_INPUT_PORT = "10000"
$env:PLAXIS_BUNDLE_PYTHON = "C:\Path\To\PLAXIS\python.exe"
py -3.13 -I -u -m plaxis_mcp.server

ツール

各プロセスのロールは変更できません。両方が必要な場合、クライアントは Input と Output を個別の MCP サーバーとして登録します。

Input ツール 34 個 · Output ツール 11 個。

• connect() はエンドポイントや認証情報の引数を取りません。固定されたロール設定のみを使用するため、エージェントが保存済みパスワードを任意のホストに転送することはできません。
• ロールのステータスリソースは plaxis://input/status と plaxis://output/status にあります。
• get_results(phase, result_type_path, fem_type="node", offset=0, limit=200) は、データを失わずにページ分割します。limit は 1～5,000 です。レスポンスには count、offset、limit、returned_count、has_more、next_offset、results が含まれます。
• 結果内の各オブジェクトには path が含まれます。これは、あらゆる参照パラメーターに渡せる正確な文字列です。list_objects(kind) は、ジオメトリの概要（座標、またはバウンディングボックスを返すオブジェクトの場合は解析済みの bounds）とともに、その種類のオブジェクトをすべて同じ形式で一覧表示します。
• model_state() は、calculate を試みる前に、メッシュのステータス、フェーズテーブル、未割り当ての材料を報告します。モデル内の問題である blocking、ここでは実行できなかったチェックである unknown、PLAXIS がまったく公開していない情報（2D V22 でメッシュがジオメトリと一致しているかどうかなど）である caveats を区別します。そのため、blocking が空でも問題がないと誤認することはありません。
• 結果は Output サーバー上にあり、PLAXIS Output アプリケーションで開いている内容を読み取ります。計算済みのフェーズを Output に表示するには、Input サーバーの view_results(phase) を使用します。
• PLAXIS が呼び出しを拒否した場合、PLAXIS 自身のメッセージも plaxis_message に含まれます（サニタイズ済み：ファイルシステムのパスとスタックフレームを除外し、切り詰めたことは別途フラグで示します）。calculate が失敗した場合は、フェーズごとのテーブルも details に含まれます。

クライアント

同梱されているすべてのサンプルにはシークレットが含まれておらず、ロールごとに 1 つ、計 2 つのサーバーエントリーを使用します。 コマンドを plaxis-mcp.exe の保存場所に置き換えるか、PyPI からインストールする場合は uvx plaxis-mcp に置き換えてください。 それ以外は編集不要です。--role が共有プロファイルを自動的に見つけます。

汎用の mcp-client-config.json は、この一般的な JSON 形式を使用するクライアント向けの最小限の mcpServers サンプルです。

PLAXIS のパスワードをバージョン管理、コマンドライン引数、ログ、プロファイルファイルに決して追加しないでください。

セキュリティモデル

• プロファイルは 1 つのインストール環境に紐付けられます。 credential_target は installation_root から導出され、worker_python は検出処理によって同じルートに紐付けられたインタープリターでなければなりません。これら 3 つの値のいずれかを手動で編集すると、プロファイルを読み込めなくなります。これにより、プロファイルから保存済みの PLAXIS パスワードが任意の実行可能ファイルに渡されるのを防ぎます。
• 環境変数による上書きはマージではなく拒否されます。 PLAXIS_* エンドポイント変数が設定されている場合、serve は起動を拒否します。
• 未認証の組み合わせはフェイルクローズします。 Python の一致判定は厳密です。異なるパッチレベルの 3.7 系インタープリターは、認証されていない別の ABI と見なされ、互換性があると推測されるのではなく拒否されます。
• 変更前に確認します。 すべてのクライアントで call_method やプロジェクト／ファイルを変更するツールの実行前に確認を求めるようにしてください。call_method、open_project、save_project に対して「常に許可」のようなルールを設定しないでください。クライアントの承認は通常、引数単位ではなくツール全体に適用されます。
• 変更は元に戻せません。 PLAXIS からアクセス可能な絶対ローカルパスおよび UNC の .p2dx パスは、ユーザーの承認後にのみ使用できます。クライアントの承認やクライアント側のチェックポイント機能では、メモリ上の PLAXIS の状態を復元できません。変更を伴うテストには、使い捨てのプロジェクトとバックアップを使用してください。

アーキテクチャ

PLAXIS-MCP は、MCP ホストを PLAXIS のベンダー管理下にある Python ランタイムから分離します。

  MCP client  ──stdio──▶  host (CPython 3.13, mcp 1.26.0)
                              │
                              ├─ private local pipe
                              ▼
                          role-pinned worker (PLAXIS bundled Python)
                              │
                              ▼
                          PLAXIS Remote Scripting @ 127.0.0.1

• クライアントとの通信には常に stdio 上の MCP を使用し、通常のログと診断情報は stderr に出力します。
• PLAXIS-MCP は、PLAXIS の Python バンドルへのパッケージのインストール、アップグレード、再配布を一切行いません。

この分離が必要なのは、MCP ホストには最新の Python ランタイムが必要である一方、PLAXIS にはバージョン固有のスクリプト環境が付属しているためです。

V20 と V21 はレガシープロファイルを共有します。サポート終了済みの Python はループバックワーカー内で隔離され、組織によるセキュリティ上の承認が必要です。

要件

• Windows、および Remote Scripting が有効な、サポート対象のローカル PLAXIS 2D インストール。
• MCP ホストには CPython 3.13 が必要です。サポート対象のホスト範囲：>=3.13,<3.14。
• ループバックのみで待ち受ける PLAXIS Input サーバーおよび／または Output サーバーを 1 つ。デフォルトは Input 127.0.0.1:10000、Output 127.0.0.1:10001。
• 選択済みの認定済み PLAXIS 同梱 Python プロファイル。MCP ホスト環境に plxscripting をインストールしないでください。

C:\ProgramData\Seequent\PLAXIS Python Distribution V2\python\Lib\site-packages
C:\ProgramData\Bentley\Geotechnical\PLAXIS Python Distribution V2\python\Lib\site-packages

Docker、WSL、リモート MCP トランスポート、および Python 環境にコピーした PLAXIS バンドルは、v0.3 のサポート対象のデプロイ方法ではありません。以前の Docker 成果物は意図的に削除されました。

開発と検証

# unit suite, from the CPython 3.13 host environment
py -3.13 -m unittest discover -s tests

# inspect the split host/worker configuration without starting PLAXIS
py -3.13 scripts/smoke_test.py

リリース前に、クリーンな環境でホスト用の wheel／インストーラーを検証し、pip check の結果を確認し、成果物にベンダーファイルが含まれていないことをスキャンし、プロトコル 2025-03-26 で MCP コントラクトを検証し、有効化するすべての PLAXIS プロファイルについて、計算済みの使い捨てプロジェクトを用いたライブ認証を完了してください。

参考資料

MCP Python SDK · Codex · Claude Code · Cursor · VS Code