ツール一覧

公開されている 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", "beams" }。beams は所属小梁の実体配列
• wall_region: { "id", "name", "boundary", "wall_plate_ids", "posts" }。posts は所属間柱の実体配列
• unassigned_beam / unassigned_post: どの領域にも入らなかった二次部材の配列
• secondary_beam: 領域内と未割当を合わせた小梁の実体配列

model_edit

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

返り値:

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

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

壁版（9）

囲まれた壁版は任意の節点境界からは作れません。柱・梁・間柱から導出した壁版割当領域 （準備計算が作る）へ AssignWallPlateToRegion で割り当てます。四辺の対称性から 割当領域の境界がそのまま壁版の境界になります。

壁版割当領域への割当の例:

{
  "command": "AssignWallPlateToRegion",
  "region": 0,
  "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" }
}

床板（10）

囲まれた床板は任意の節点境界からは作れません。大梁・小梁から導出した床板割当領域 （floor_assignment_region）へ割り当てます。割当・版なし・未設定は同一 Undo 単位です。

AddAttachedSlab のフラット引数の例:

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

床領域（2）

secondary_beams を省略するとエラーになります（欠落を空配列とみなしてリストを消すことはしません）。旧小梁語彙のコマンドやキーは受け付けずエラーになります。

未割当二次部材（4）

同じ端点の小梁・間柱が既にあるときは適用されず applied: false になります。SecondaryMember は id（安定 ID）・kind・ends（支持部材アンカー／片持ち自由端）・section・name を持ちます。端部支持条件は SetSecondaryMemberEndSupport で設定できます。

二次部材の端部支持条件（1）

安定 ID で対象の小梁・間柱を探し、床領域内・壁領域内・未割当のいずれにあっても設定します。支持端は現在の端部座標から支持部材アンカーへ再解決し、片持ち小梁は自由端の位置を "Free" にします（例: "end_support": ["Supported", "Free"]）。同じ条件のときは適用されず applied: false になります。

二次部材の配置・移動・削除（3）

PlaceSecondaryMember は安定 ID を新規に払い出し、親領域（floor なら小梁、wall なら間柱、unassigned なら未割当）へ追加したうえで床板・壁版割当領域を再構築します。ends は {"Supported": [{"support": {"Primary": 0}, "position": 0.5}, ...]} のように支持部材アンカーで指定します。支持が決まらない端（Detached）、種別に合わない親、支持端が親領域（SecondaryParent が指す床領域・壁領域）の内側または境界上（許容差 10 mm）にない場合は適用されず applied: false になります（片持ちへの読み替えはしません）。SetSecondaryMemberEnds も同じ親領域内判定を行い、移動先が現在の所属領域の外へ出る場合は適用されません。

配置・移動・削除では、境界が変わって参照先を失った囲まれた床板・壁版を取り除き、新しい割当領域を未設定にします。版の除去まで含めて 1 つの Undo 単位です。ends の解析に失敗した場合は ends の解析エラーを返します。

壁領域（1）

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

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

quantity_takeoff

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

返り値:

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

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

数量の算定式は数量積算を参照してください。

analysis_run

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

返り値:

{ "job_id": "job-0" }

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

Done の result_ref（サマリ JSON）には、解析結果に加え、前処理の注意事項があれば notices 配列が付きます。たとえば ai_mode="SemiPrecise" かつ design_period 未指定のときは EX/EY を同期せず、その旨が notices に入ります（ジョブ自体は完了します）。未設定の床板・壁版割当領域が残っている場合も、件数と対象 ID を記した警告が notices に入ります。GUI のように計算前の確認は挟まず、警告を結果へ添えて計算は続行します（未設定は荷重・剛性を過小評価し得るため、結果を採用する前に必ず解消してください）。

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 の列構成は解析ジョブのフローと結果ストアを参照してください。