Archicad AI Pilot— MEPbridge ACAIstr | Version v0.1.6 , Precise Reliable I/O & End-to-End

[Bleufeng]

Archicad是一款专为建筑师量身打造的真正面向未来的三维设计软件。然而，建筑、机电及其他各专业之间的跨学科协同整合，仍然是推动其在全行业普及应用的一大长期瓶颈。

这个项目源于一个长期存在的行业痛点：在Archicad中，建筑与机电专业的跨专业协同长期以来未能在各团队间得到广泛推广。随着人工智能的兴起，Blender、Rhino和Revit纷纷推出了基于MCP的自动化功能，这促使我利用业余时间开发了这款工具。尽管目前尚无法全面支持端到端的真实世界建筑项目，但它已证明是一项关键性突破：人工智能能够读取设计文件中存储的所有参数，并触发相应的软件操作。这一解决方案的全部技术潜能仍有待进一步挖掘，其关键在于大型语言模型的迭代演进以及未来功能的持续拓展。其核心宗旨在于为建筑师提供一条开放、实验性的技术路径，以探索人工智能赋能的设计。除作为一款独立的Archicad MCP连接器外，该工具还集成了两种运行模式——由AI驱动的智能工作流与手动指令控制——并配备了一个可扩展的平台，支持用户自定义扩展。 项目 MEPbridge ACAIstr 已开源，可在 GitHub 上下载，地址为https://github.com/bleufeng/mepbridge-acaistr 

所用操作系统：Windows

• 建筑通用构件：墙体、柱、梁、板、屋面、门、窗、楼梯、对象、灯具、网格、区域和轴网
• 机电专业领域：管道、风管、电缆桥架、柔性管段、工程量统计、系统、规格以及管线敷设操作
• 模型编辑：移动、旋转、镜像、复制、几何体修改、批量创建、选择与删除
• 项目查询：项目信息、故事、库、热链接、属性、几何体、网格以及视口捕捉
• CollabAI 智能 与 手动 操作模式，具备风险分级、确认闸门及结果回读功能
• MCP 工具由ai-adapter/tool-descriptors.json 动态生成
• 本地用户模板、自定义命令、知识库、学习记忆和审计日志
• AC28/AC29 支持根据操作风险进行预览、确认、结果回读及故障处理

[Bleufeng]

v0.1.2 -Changed
Installation guides document the Node.js prerequisite, custom install paths, and a full step-by-step manual installation procedure covering administrator rights, locating the Archicad folder, choosing between Archicad 28 and 29, handling a previous build, and verifying the result.
The registered command and descriptor counts now come from a single ai-adapter/command-boundary.json file that the release gate, the public repository validator, CI, and the packaging scripts all read, instead of each carrying its own copy.
Command examples no longer contain hardcoded MEP system names or attribute indexes. Those identifiers are not stable across projects, locales, or Archicad versions, so omitting them lets the Add-On use the domain default. A static check keeps them out.
The Archicad runtime regression now checks returned content rather than only that response fields exist, and covers the favourite, layer-batch and classification write commands end to end, each restoring what it changed.
The internal command guide lists all 74 registered commands. It had 52, so the favourites, profile, view-map, classification and layer commands were absent along with the project and story queries. Command counts there now defer to ai-adapter/command-boundary.json.
The public repository validator no longer aborts on a Markdown link containing a stray percent sign; such a link is reported as broken instead.

[catalinpopa]

claude is also working on this, what s the difference?

[Bleufeng]

This refers to Claude Design?  While Claude, GPT and Gemini already have their respective native MCP connections, they lack professional parsing for Archicad’s internal models. From an architectural‑specialty perspective, our goal is to add a dedicated BIM‑MCP vertical‑adaptation layer for Archicad, translate complex BIM model data into structured data readable by any large language model, and provide open, customizable extensions for any interface.

[Bleufeng]

v0.1.3 -Changed

Fixed

• Slab, Roof, and Zone creation now accepts closed polygon contours.
• Zone creation now uses the supplied contour and correctly writes the zone name
  and category.
• Explicit slab thickness is now applied correctly.
• Degenerate polygon input now returns a clear validation error.
• Copying Mesh and Morph elements is now supported.
• MCP client status now uses the initialize handshake and distinguishes
  connected clients from configured clients.
• Public CI now exports only the approved command-safety test from the private
  test directory.

Added

• Added a read-only endpoint for listing running Archicad instances and their
  open projects.

[Bleufeng]

v0.1.4 -Changed

Fixed

- Explicit wall heights are no longer clamped to the story height.
- Walls now use the center reference line; the body no longer shifts sideways.
- Window sill height is applied; openings above the host wall top are rejected.
- Windows and doors inherit the host wall's story.
- `set_active_story` previews by default and reports `previousStoryIndex`.
- Stair tread depth is reported as the effective `resolvedGoing`.
- Workbench template replay refreshes saved templates before execution.
- Fixed bug causing slow reproduction of user‑defined templates in Workbench.

Added

- Moving and editing building elements by GUID with per-field masks and readback.
- Optional absolute-Z placement for walls, columns, objects, and lamps.
- Mirror and rotate accept explicit GUID lists.
- Four local server tools: list Archicad instances, capture/compare/replay snapshots.
- Copy is all-or-nothing with a single undo; delete is capped at 200 per call with `acknowledgeCount` above 50.

[Bleufeng]

v0.1.5 -Changed

Fixed

• Roof geometry readback returns the full closed contour in model coordinates, fixing shifted or incomplete outlines in comparison and copy workflows.
• Stair rule prechecks use a 1 mm tolerance for riser height, going, and 2R+G, preventing valid native stairs from being rejected by rounding noise.

Added

• Field-level editing for Column, Beam, and Slab, with precise field masks and readback.
• Controlled vector and two-direction array multiplication for Wall, Column, Beam, Slab, Roof, Mesh, and Morph by explicit GUID.
• Read-only inventories for nine attribute families and native documentation element types.
• Minimal native Text, linear Dimension, and single-line Label creation.
• Story setting changes and guarded story deletion with full story snapshot verification.
• First supported trim round: one Wall with one Roof operator using KeepInside or KeepOutside.
• First supported solid-operation round: two Morph elements using Subtract or Add.
• Dual-instance targeting keeps reads and writes bound to the selected Archicad instance and fails closed on invalid or dead target ports.

[Bleufeng]

v0.1.6 -Changed

fix and capability release: rebuilt AC28/AC29 Add-Ons, corrected element move and roof geometry handling, and added create-with-properties, beam vertical placement, wall constraint and reference-line control, movable roofs, and clearer readback diagnostics across the Workbench Server and MCP tools.