AIBIMTool

AIBIMTool Skills

使用 AIBIMTool 将建筑设计为真实 BIM 模型的 AI Agent 技能。描述一栋建筑；AI 建筑师会研究建筑类型，询问只有你才能回答的少数问题，规划大型工作，然后将每一层、墙体、楼板、门、窗、房间、楼梯和屋顶建模为 IFC4，并根据你的要求修改模型。适用于 Claude、ChatGPT、Claude Code、Cursor、Codex、VS Code、Windsurf，以及任何能够加载 Markdown 技能或支持 MCP 的工具。

每位用户都使用自己的 AIBIMTool 账户登录，每条消息的费用从该账户的额度中扣除。这些技能通过 MCP 服务调用公开的 AIBIMTool API，因此无需构建任何内容，也无需安装 BIM 内核。

_{一份设计需求，一份包含 1,065 个构件的 IFC4 模型：标注了所有房间尺寸的二层平面图，以及建筑本身。}

安装

任选一种方式。每种方式都会为你的 Agent 配置技能。

npx skills（推荐，支持多种 Agent）

npx skills add MeltFlexDevs/aibimtool-skills

GitHub CLI（v2.90+）

gh skill install MeltFlexDevs/aibimtool-skills

Claude Code marketplace

在 Claude Code 中：

/plugin marketplace add MeltFlexDevs/aibimtool-skills
/plugin install aibimtool@aibimtool

该插件会一并提供托管的 MCP 服务：运行 /mcp，然后选择一次“Authenticate”（身份验证）。

仅安装 MCP 服务

如果你只想使用工具，不需要技能，请添加托管服务。它会使用你的 AIBIMTool 账户为你登录，无需密钥：

claude mcp add --transport http aibimtool https://aibimtool.com/mcp

在 Claude（claude.ai 或 Desktop）和 ChatGPT 中，将 https://aibimtool.com/mcp 添加为自定义连接器。若要使用带 API 密钥的本地服务：claude mcp add aibimtool -- npx -y aibimtool-mcp。Cursor、Codex、VS Code 和 Windsurf 的配置见 INSTALL.md 和 MCP 页面。

安装脚本

通用备用方案：

git clone --depth 1 https://github.com/MeltFlexDevs/aibimtool-skills.git
cd aibimtool-skills
./setup

更多选项见 INSTALL.md。由 Agent 驱动的安装方式（可粘贴到你的 Agent 中）：INSTALL_FOR_AGENTS.md。

身份验证

托管服务 https://aibimtool.com/mcp 无需密钥：你的客户端会打开 AIBIMTool 登录页面。与 API 和 CLI 一样，它属于 Studio 方案的一部分。

本地服务和 CLI 使用 API 密钥，同样属于 Studio 方案。最简单的获取方式是通过浏览器流程：它会根据你的会话生成密钥，并通过回环连接将密钥交还给你，因此你无需复制或粘贴机密信息：

npx -y aibimtool-mcp auth login

也可以在 aibimtool.com → Developers → API keys 手动创建密钥并将其导出：

export AIBIMTOOL_API_KEY="aibim_sk_..."

密钥只会在创建时显示一次。系统只存储其 SHA-256，因此之后无人能够找回，包括我们。一个账户最多可持有五个有效密钥，撤销密钥后会在下一次请求时生效。

技能

技能	调用方式	涵盖内容
aibimtool-design	/aibimtool:design	从需求说明到 BIM 模型：如何撰写能让 Agent 妥善构建模型的需求说明、Agent 会提出哪些问题、如何批准计划、跟进构建过程，以及楼层和成本。
aibimtool-bim	/aibimtool:bim	模型完成后的所有事项：IFC 文件、如何在 Revit、ArchiCAD、BlenderBIM 或 Tekla 中打开、用于检查模型的图片，以及修改。

工具

工具	功能	费用
create_building	根据需求说明开始一项新设计；立即返回项目 ID	按用量计费
get_project_status	查看状态、Agent 的回复、问题或计划；在任务运行时等待	免费
send_message	向项目的 Agent 发送回答、修改和后续消息	按用量计费
approve_plan	批准 Agent 的计划并开始执行	按用量计费
continue_building	任务因达到时间限制而停止后继续构建	按用量计费
get_model_image	3D 视图，或一层的平面图，其中标有每个房间的名称和尺寸	免费
get_ifc_download	IFC4 模型：磁盘上的文件（本地）或链接（托管）	免费
list_projects	账户中的项目	免费
stop_building	在 Agent 完成当前步骤后停止运行	免费
check_credits	查看套餐和剩余积分	免费

按用量计费表示会根据所用 AI 收取消息费用：每 0.02 美元计 1 个积分，每个 8 分钟时段最多 150 个积分。如果任务在我们这边失败，费用会自动退还，因此 Agent 重试时不会悄悄耗尽余额。

建造一栋楼需要几分钟，远超聊天会话保持工具调用打开的时长，因此 create_building 会立即返回；Agent 工作期间，get_project_status 每次调用最多等待 50 秒。本地服务会将 IFC 文件和图片写入磁盘（除非传入 output_path，否则写入 ./aibimtool-output/），并返回路径，而不是文件数据：IFC 文件有数 MB，而且 Agent 通常会直接将其交给下一步。

实际效果

你： 设计一栋 7 层办公楼，设有一层大堂、咖啡馆和活动空间。2 至 4 层为标准办公楼层，围绕设有楼梯、电梯和洗手间的中央核心布置。增加一个屋顶露台。

[create_building]     brief: "Design a 7-story office building with a ground-floor lobby, …"
→ project 019cf06362ab4dac · running

[get_project_status]  wait_seconds: 50
→ needs_answer
  1. Floors 5-7: Same typical office floors / Offices plus a top-floor amenity / Larger-tenant floors
  2. Floor plate: About 800 m² / About 1,200 m² / About 1,800 m²
  3. Massing: Rounded bar on a glazed plinth / Two offset volumes with a cantilever / Stepped terraces

> You: Offices plus a top-floor amenity, about 800 m², rounded bar on a glazed plinth.

[send_message]        → needs_approval: a five-task plan
> You: Go ahead.
[approve_plan]        → running
[get_project_status]  → ready · 1,065 elements

[get_model_image]     view: plan · storey: 1
→ ./aibimtool-output/019cf06362ab4dac-plan-storey-1-2026-10-28-14-02-09.png
[get_ifc_download]
→ ./aibimtool-output/design-a-7-story-office-building-with-a-2026-10-28-14-02-11.ifc

这是一次真实运行：问题、计划和 1,065 个构件均由 Agent 根据该需求说明生成。IFC 文件可在 Revit、ArchiCAD、BlenderBIM、Tekla 和 Navisworks 中打开；项目也可在 AIBIMTool 3D 查看器中打开并继续修改。更多模式见 COOKBOOK.md。

优质需求说明能改变一切

Agent 会根据需求说明进行构建，并研究其余事项，同时说明自己的假设。明确写出建筑类型、规模、楼层数和重要房间的需求说明，通常能在首次运行时生成设计；含糊的说明则会先引发问题。传入用户的原话，补充他们已经提供的信息，绝不要为了让需求看起来完整而凭空添加要求。这是整个工作流中影响质量最大的因素。

CLI

如果运行时传入参数，而不是让 Agent 通过 MCP 与其交互，同一个包也可作为命令行工具使用：

aibimtool build "Kindergarten for 60 children, one storey, 4 groups" --wait --yes --ifc kindergarten.ifc
aibimtool send 019cf06362ab4dac "Make the event space open to the terrace" --wait
aibimtool image 019cf06362ab4dac --storey 1 -o level-2.png

完整参考见 aibimtool.com/developers/cli。

文档

• API 参考：所有端点、请求和响应
• CLI：所有命令和标志
• MCP：针对每种客户端的配置说明
• COOKBOOK.md：示例详解
• CONTRIBUTING.md

许可证

MIT。请参阅 LICENSE。