Archicad

Archicad MCP

将 Claude、ChatGPT 或任意 MCP 客户端连接到 macOS 和 Windows 上正在运行的 Archicad 29（Archicad 30 也适用）。你用自然语言提出要求；服务通过 Archicad 的 JSON API 和 Tapir 插件执行操作。

• 根据办公室标准检查模型。 对打开的模型运行 YAML 规则：显示通过或失败、得分和不符合规则的元素，并将其高亮显示或转为问题。
• 查找、读取和修改元素。 条件查询、属性、分类、GDL 和 IFC 数据、收藏夹、属性项、碰撞检查。
• 创建元素。 墙、板、柱、门窗、区域、楼梯、尺寸标注，以及其他 30 多种类型。
• 其他所有操作。 通过一个网关调用约 500 个官方命令和 Tapir 命令。

警告

读取属性前请先保存。 Archicad 29 读取属性时可能崩溃，即使只读取一个元素也不例外，并导致未保存的工作丢失。服务无法避免此问题。请让客户端先运行 save_project，并参阅 已知问题。

安装

Claude Desktop： 从最新版本下载适用于你平台的安装包，并将其拖入设置 > 扩展。安装包自带 Python，因此无需安装其他内容。

平台	文件
Windows	archicad-mcp-0.12.0-win32.mcpb
macOS（Apple 芯片）	archicad-mcp-0.12.0-darwin-arm64.mcpb

Claude Code（需要 uv）：

uv tool install archicad-mcp-server
claude mcp add archicad -- archicad-mcp --mode full

Tapir： 大多数工具都需要在 Archicad 中安装 Tapir 插件。请让客户端安装 Tapir，或运行 archicad-mcp install-tapir。它会将固定版本的 Tapir 1.7.3 安装到 Archicad 的 Add-Ons 文件夹，通过 sha256 校验，并且除非收到明确指示，否则绝不替换已有版本。之后重启 Archicad。

Intel Mac、手动编写的 Claude Desktop 配置、ChatGPT、Codex 及所有设置说明：安装。

检查是否正常运行

打开 Archicad 后，请让客户端列出 Archicad 实例。结果会显示端口、Archicad 版本、已打开的项目和 Tapir 版本，以及缺少组件时需要安装的内容。如果客户端完全没有显示工具，请参阅检查是否正常运行。

可以提出哪些要求

领域	工具
QA	audit_delivery_readiness、run_rule、list_rules、verify_ifc_export_readiness、highlight_failures、create_issues_from_failures
查找和读取	find_elements、search_definitions、get_element_data、get_model_summary、get_project_info、list_attributes、find_collisions
修改	set_element_data、modify_elements、apply_favorites、move_elements、delete_elements、edit_attributes、edit_property_definitions、edit_classifications
创建	create_elements（40 种类型）、create_swept_beam、create_road_marking，以及用于从草图放置家具、门窗的 learn_library_part
查看	show_elements、capture_window、选择工具
问题和输出	Issue Manager 和 BCF、export_ifc、publish、save_project
团队协作	reserve_elements、release_elements
明细表	通过 Scheme Settings 的 XML 使用 read_schedule_scheme、edit_schedule_scheme、validate_schedule_scheme（Archicad 没有明细表 API）
库部件	将网格模型（OBJ、3DS）转换为 GDL 对象：build_gdl_object、deploy_gdl_object
网关	list_api_commands、describe_api_command、execute_read_api_command、execute_write_api_command

每个工具的详细说明，包括检查内容和所需条件：工具。

默认安全。 对元素、数据和定义所做的更改都会先以试运行方式展示当前值和新值。删除和移动操作还需要 confirm=true。对于 Archicad 会拒绝操作的元素（属于其他视图、所在图层已隐藏或锁定、位于热链接模块中，或在 Teamwork 中未预留），系统会跳过并说明原因，绝不会解除锁定。提交后会读取已写入的数据，并报告未能生效的内容。

办公室规则

规则是 YAML 文件，存放在你指定给服务的文件夹中（扩展的 Office rules folder 设置，或 ARCHICAD_MCP_RULES_DIR）：

- id: walls-fire-rating
  type: property-required
  property: "OFFICE/Fire Rating"
  applies_to: { element_type: Wall }
  severity: error

内置了六种规则类型，自定义检查则放在 YAML 文件旁边的 Python 文件中。请将实际的办公室标准保存在此仓库之外。参见编写规则。

文档

• 安装：所有安装方式、Tapir、配置
• 工具：所有工具、检查内容及所需条件
• 已知问题
• 查找元素和 读取和写入元素数据
• 编写规则
• 明细表
• GDL 流程和脚本编写
• API 仪表板： 所有可访问的命令，以及哪些命令配有工具
• 开发：测试、Tapir、软件包、发布

隐私

此服务在你的计算机上运行，只与 127.0.0.1 上的 Archicad 通信。没有遥测，也没有后端。服务读取的内容会发送给发起请求的 MCP 客户端，通常是 Claude，并遵循该客户端的隐私条款。参见 PRIVACY.md。

许可证

MIT。参见 LICENSE。