ツール一覧

公開されている MCP ツールは以下の 6 個です。

model_query

節点・部材・断面・壁版・床板・床領域・壁領域・二次部材を検索します。

返り値:

{ "items": [ /* 検索結果の JSON オブジェクト配列 */ ] }

• node: { "id", "coord", "story" }
• member/element: { "id", "kind", "nodes", "section", "material" }。部材付帯情報（ハンチ・継手位置）があれば haunch_i/haunch_j（length/depth_increase/width_increase）と joints（distance/kind）を追加。入力モデルに保存されている部材だけを返す（壁版から都度生成する耐震壁は含まない。壁は kind=wall_plate で照会する）
• section: { "id", "name", "area", "iy", "iz" }
• wall_plate: { "id", "shape", "section", "opening_area", "opening_weight", "slit", "openings", "loads", "becomes_element" }。slit は { "column_face": [bool, bool], "beam_face": [bool, bool] }（耐震スリット。梁際は 0 が下辺、1 が上辺）、loads は仕上げ・増打ちの面荷重 [N/mm²]（躯体の自重は含まない）、becomes_element はその壁版から壁エレメントが生成されるか。shape.kind は "Enclosed"（boundary）または "Attached"（anchor・extent・resolved_extent）。extent は入力値そのもので null は階高いっぱいを表し、resolved_extent は階レベルから解決した高さ（null は直上に階が無く解決できない。解析前チェックが止める）
• slab: { "id", "shape", "section", "loads", "usage", "method", "one_way" }。shape は壁版と同じく "Enclosed" / "Attached"
• floor_region: { "id", "name", "boundary", "slab_ids", "secondary_joists" }。secondary_joists は所属小梁の実体配列
• wall_region: { "id", "name", "boundary", "wall_plate_ids", "posts" }。posts は所属間柱の実体配列
• unassigned_joist / unassigned_post: どの領域にも入らなかった二次部材の配列
• secondary_joist: 領域内と未割当を合わせた小梁の実体配列

model_edit

モデルを編集します。GUI と同じ EditCommand と Undo 履歴を使います。引数は command キーで種別を指定する JSON オブジェクトです（トップレベルに command を置く）。{ "body": { "command": "...", ... } } という入れ子も受け付けます。

返り値:

{ "op_id": "op-1", "applied": true, "undoable": true, "summary": "..." }

• applied が false のときは、参照検証などでコマンドが Noop になった（モデルは変わらない）
• 節点・部材・荷重・断面そのものの追加削除など、下表にない EditCommand は未対応（エラー）

壁版（7）

囲まれた壁版の例:

{
  "command": "AddEnclosedWallPlate",
  "boundary": [0, 1, 2, 3],
  "section": null,
  "opening_area": 0.0,
  "opening_weight": 0.0
}

取付き先 anchor が線のときの形（nodes は取付き梁の 2 節点、span は梁全長に対する無次元区間）:

{
  "Line": { "nodes": [0, 1], "span": [0.0, 1.0], "transfer": "Anchor" }
}

床板（8）

AddAttachedSlab のフラット引数の例:

{
  "command": "AddAttachedSlab",
  "anchor": { "Line": { "nodes": [0, 1], "span": [0.0, 1.0], "transfer": "Anchor" } },
  "extent": [1000.0, 1000.0],
  "section": 0
}

床領域（3）

secondary_joists を省略するとエラーになります（欠落を空配列とみなしてリストを消すことはしません）。SetFloorRegionJoists・SetSlabSecondaryJoistIds、およびキー secondary_joist_ids / ids は受け付けずエラーになります。

未割当二次部材（4）

同じ端点の小梁・間柱が既にあるときは適用されず applied: false になります。

壁領域（1）

posts を省略するとエラーになります。壁領域の新規作成・削除は公開していません（準備計算が壁領域を作り直すため）。

床領域の新規作成・削除は公開していません（準備計算が床領域を作り直すため）。

quantity_takeoff

数量積算（コンクリート体積・型枠面積・鉄筋/鉄骨重量の概算）を集計します。

返り値:

{ "rows": [ /* group_by に応じた行 */ ], "totals": { "concrete_m3": .., "formwork_m2": .., "rebar_t": .., "steel_t": .., "rebar_joints": .. }, "notes": [ /* 注記 */ ] }

rows の形は group_by により異なります。

数量の算定式は計算根拠 10. 数量積算を参照してください。

analysis_run

解析を非同期で実行し、ジョブを登録して job_id を即座に返します（計算完了は待ちません）。

返り値:

{ "job_id": "job-0" }

kind ごとに使用するパラメータと概略処理:

Done の result_ref（サマリ JSON）には、解析結果に加え、前処理の注意事項があれば notices 配列が付きます。たとえば ai_mode="SemiPrecise" かつ design_period 未指定のときは EX/EY を同期せず、その旨が notices に入ります（ジョブ自体は完了します）。

analysis_status

ジョブの状態を取得します。

返り値:

{ "id": "job-0", "kind": "LinearStatic", "status": { /* Queued | Running{progress} | Done{result_ref} | Failed{error} */ } }

• status は次のいずれかの形を取ります。
  • "Queued"（ジョブ登録直後の内部状態。通常は analysis_run がすぐに実行を開始するため、ポーリングではほとんど見えません）
  • { "Running": { "progress": 0.0 } }
  • { "Done": { "result_ref": "<サマリ JSON 文字列>" } }
  • { "Failed": { "error": "<エラーメッセージ>" } }
• job_id が存在しない場合はエラー（invalid_params）。

result_get

解析結果ストアから結果を取得します。

返り値:

{ "case": 1, "kind": "NodalDisp", "rows": [ /* 明細行 */ ], "truncated": false }

(case, kind) の組が結果ストアにない場合はエラーになります（analysis_run を先に実行する必要があります）。 各 kind の列構成は解析ジョブのフローと結果ストアを参照してください。