● Model Context Protocol · streamable-http · 14 ツール
bim.house MCP の使い方
AI エージェント (Claude 等) が建材カタログ検索・物件 (bim.json) 作成・建築基準法チェック・概算見積を直接実行できる MCP サーバーです。認証なしで読み取り・物件作成まで使えます。
エンドポイント
POST https://bim.house/mcp JSON-RPC 2.0 (initialize / tools/list / tools/call)
GET https://bim.house/mcp サーバー情報 (ツール名・プロトコル)
GET https://bim.house/.well-known/mcp ディスカバリ
CORS 開放。読み取り・
create_house は
認証不要。書き込み後の編集 (
set_visibility 等) は
create_house が返す
edit_token が必要です。
whoami に
Authorization: Bearer <APIキー> (
/console 発行) を付けるとアカウント紐付けも可能。
Claude Code に登録
claude mcp add --transport http bim-house https://bim.house/mcp
登録後はチャットで「弟子屈に平屋の物件を作って」のように頼むと
create_house が実行され、
viewer リンクが返ります。
ツール (14 個)
whoami 🔑chatsearch_catalogget_productlist_housesget_house_bimhouki_checkmaterial_quotecreate_house ✏️create_product ✏️update_product ✏️list_mine 🔑retire_product ✏️set_visibility ✏️
✏️=書き込み (edit_token を返す/要する) ・ 🔑=API キー認証に対応
| ツール | 説明 |
|---|
whoami 🔑認証 | API キー認証の確認。Authorization: Bearer <APIキー> (/console で発行) を付けると認証済みアカウントの email を返す。Web/CLI どちらからでも使える。 |
chat | bim.house / MU の AI チャット。メール認証して /console で発行した API キーで認証必須 (Authorization: Bearer <APIキー>)。未チャージでも初回 ¥300 分 (5 回) は無料、使い切ったら /credits でチャージ。建築・BIM・法規・SIPs・MU について日本語で答える。引数 message (必須) と history (任意, [{role, content}])。 |
search_catalog | bim.house の建材・設備カタログ (3,900+ SKU) を検索。窓/断熱/設備/家具などを brand・category・キーワードで絞り込む。 |
get_product | SKU を指定して 1 製品の詳細 (価格・性能値 U値/η値・在庫・JAN・後継品) を取得。 |
list_houses | 公開物件 (有名建築・巨大ランドマーク・SOLUNA 等) の一覧。slug / 規模 / 要素数 / bim.json 充足率(%) を返す。 |
get_house_bim | slug を指定して物件の完全な bim.json v1 (project メタ + elements 配列) を取得。include_elements=false でメタのみ。 |
houki_check | 建築基準法チェック (建ぺい率・容積率・北側/道路斜線・採光・換気) を houki-engine で実行し合否を返す。 |
material_quote | カタログ連携の概算見積もり。BIM 要素 takeoff × 建材カタログ実価格 (窓/ドア/設備) + 原単位 (躯体/仕上げ) で BOM・総額・㎡単価を算出し、各資材の納期 (lead_time_days) と在庫、クリティカルパス納期も返す。 |
create_house ✏️書込 | 新しい物件 (bim.json) を作成する。name は必須。elements (bim.json v1 要素配列) を渡すとそのまま保存、省略すると敷地寸法から簡易シェルを自動生成。slug と edit_token、viewer/json/permit URL を返す。 |
create_product ✏️書込 | 建材カタログ (products) に新しい製品 SKU を登録する。サッシ/窓/断熱材/照明/設備/家具/ドア等。Authorization: Bearer <APIキー> (/console で発行) が必須。登録後は /catalog と search_catalog に即反映。既存 SKU の上書きは不可 (insert-only)。 |
update_product ✏️書込 | 自分が create_product で登録した製品のフィールドを更新する。Authorization: Bearer <APIキー> 必須。他者/公式 SKU は更新不可。指定したフィールドのみ上書き。 |
list_mine 🔑認証 | 自分 (API キーのアカウント) が登録した製品の一覧を返す。Authorization: Bearer <APIキー> 必須。 |
retire_product ✏️書込 | 自分が登録した製品を取り下げる (生産終了化。ハード削除はしない)。Authorization: Bearer <APIキー> 必須。他者/公式 SKU は不可。 |
set_visibility ✏️書込 | 物件の掲載/非掲載を切り替える。edit_token (create_house の返り値) が必要。private=true で物件一覧から非掲載 (直リンクは残る)。進化ループの低スコア物件の淘汰などに使う。 |
例 1 — ツール一覧
curl -s https://bim.house/mcp -H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
例 2 — カタログ検索 (search_catalog)
curl -s https://bim.house/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_catalog","arguments":{"q":"断熱","limit":5}}
}'
例 3 — 法規チェック (houki_check)
curl -s https://bim.house/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"houki_check","arguments":{"slug":"tsugi-jitei"}}
}'
例 4 — 物件を作る (create_house)
curl -s https://bim.house/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"create_house","arguments":{
"name":"静寂の家",
"address":"北海道川上郡弟子屈町",
"structure":"杉CLT + 籾殻断熱",
"floors":1, "gross_m2":66, "construction_jpy":62000000,
"rooms":"瞑想土間 + 薪サウナ + 外気浴デッキ",
"private": false
}}
}'
| 引数 | 説明 |
|---|
name (必須) | 物件名 |
address / zoning / structure | 所在地 / 用途地域 / 構造 |
floors / gross_m2 / land_area_m2 | 階数 / 延床㎡ / 敷地㎡ |
construction_jpy / rooms | 概算工事費 円 / 室構成サマリー |
private | true で 物件一覧 に非掲載 (直リンクのみ)。既定 false=掲載。 |
elements | bim.json v1 要素配列 (省略時は敷地寸法から自動生成) |
返り値:
slug /
edit_token /
viewer_url /
json_url /
permit_url。public で作れば即
/property 一覧に並びます。作成後の掲載切替は
set_visibility (slug + edit_token + private) で。
関連
→ 物件一覧 ・ → REST API ドキュメント ・ → 建材カタログ ・ → bim.house トップ