bim-cli

bim-cli Claude Code 插件

bim-cli 的 Claude Code 插件清单——无界面 Revit 导出、PDF 批量导出、洪水／场地数据查询，以及离线 AEC 任务。无需启动 Revit 或任何桌面应用，即可通过 AI 助手运行。

仅限 Windows。 bim-cli 是仅适用于 Windows 的 CLI。此插件需要安装了 bim-cli 的 Windows 机器。

此插件的功能

在 Claude Code 中将所有已安装的 bim-cli 动词公开为 MCP 工具。每个工具对应一条在本机运行的 bim <format> <verb> 命令。示例工具：

• bim_pdf_text —— 提取 PDF 文本，无需打开文件
• bim_pdf_stamp —— 为 PDF 页面添加 Bates 编号或水印
• bim_pdf_split、bim_pdf_merge —— 拆分或合并 PDF 文件
• bim_site_flood_lookup —— 按地址或坐标查询洪水区
• bim_blender_convert —— 在无界面模式下转换 IFC/FBX/glTF

工具列表由 bim describe --json 动态生成——添加新的 bim-cli 驱动程序或动词后，便会自动提供相应工具。

关于此插件仓库

此仓库仅包含清单文件（JSON 和 Markdown），以及一个插件不会运行的标准库 Python 维护脚本（scripts/check_skills.py）。其中不包含：

• 插件本身的可执行代码
• 自有遥测功能
• 密钥或凭据
• 网络调用

所有操作均在本地执行：插件只会告知 Claude Code 如何将已安装的 bim 二进制文件作为本地 stdio MCP 服务（bim mcp）启动。不会在云端运行任何内容。

设置

1. 安装 bim-cli（Windows，在 PowerShell 中运行）：

   iwr -useb https://bimcli.com/install.ps1 -OutFile $env:TEMP\bim-install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File $env:TEMP\bim-install.ps1
   

   验证：bim describe --json 应列出已安装的驱动程序。

2. 将此插件添加到 Claude Code，方法是通过 Claude Code 插件目录添加，或手动将以下内容添加到项目根目录下的 .mcp.json（也可以通过 Claude Code 设置添加）：

   {
     "mcpServers": {
       "bim": {
         "type": "stdio",
         "command": "bim",
         "args": ["mcp"]
       }
     }
   }
   

3. 重启 Claude Code。运行 bim doctor，确认已安装的驱动程序运行正常。

Agent 技能（Hermes、Claude Code 及其他 Agent Skills 宿主）

skills/bim-cli/ 是一项 Agent Skills 技能，用于教 Agent 如何通过终端使用 bim：使用 bim describe 进行发现、了解输出和错误约定，以及阅读 PDF 和 Revit 驱动程序的工作说明。Claude Code 会随此插件自动加载该技能。

Hermes Agent：

hermes skills tap add HelloHowAreYouHaveANiceDay/bim-cli-plugin
hermes skills install HelloHowAreYouHaveANiceDay/bim-cli-plugin/skills/bim-cli

此技能仅适用于 Windows（platforms: [windows]），并要求 PATH 中包含 bim-cli。它不会自行运行安装程序，而是将 PowerShell 单行命令交给用户。

该技能也通过 bimcli.com 上的 Agent Skills well-known 端点提供：https://bimcli.com/.well-known/skills/index.json（从 main 分支的 skills/ 实时代理）。

hermes skills install well-known:https://bimcli.com/.well-known/skills/bim-cli

修改技能

1. 编辑 skills/<name>/，并更新其 frontmatter 中的 version:。
2. 运行 python scripts/check_skills.py，重新生成 skills/index.json（well-known 索引）。
3. 必须通过 python scripts/check_skills.py --check --scan <hermes-agent checkout> 检查：Hermes 只会安装扫描器评为 SAFE 的社区技能。切勿在技能中加入 curl ... | bash（或任何将内容通过管道传给 shell 的命令）；这会被直接拦截。
4. 合并到 main。tap 和 bimcli.com 会立即获取更新；Hermes 用户运行 hermes skills update 即可获取更新。

隐私政策

bim-cli 完全在本地计算机上运行。MCP 服务（bim mcp）不会进行任何超出各个 bim-cli 动词本身所需的网络调用（例如，洪水查询会调用 FEMA/NFHL 公共端点；PDF 操作则完全不会进行网络调用）。

哪些信息会离开你的计算机：

• 可选的匿名遥测数据：动词形式、bim 版本、操作系统、成功／错误类型、延迟时间。 绝不会发送文件路径、地址、文档内容或用户身份信息。 设置 DO_NOT_TRACK=1 或 BIM_TELEMETRY=0 即可完全选择退出。
• bim describe --json 中各动词 requires 字段声明的特定网络调用（例如，洪水查询需要 network:host）。

哪些信息绝不会离开你的计算机：

• 文档内容（PDF 页面、IFC 几何数据、Revit 模型）。
• 文件路径或文件名。
• 用户身份信息或任何个人数据。
• MCP 参数值。

完整隐私政策：https://bimcli.com/privacy

许可证

本仓库中的文件（插件清单和 MCP 服务声明）采用 MIT 许可证发布。请参阅 LICENSE。

MIT 许可证仅涵盖本仓库中的清单文件。bim-cli 二进制文件是专有软件，采用单独的许可证，可在 https://bimcli.com 查看。

更多信息

• bim-cli 文档：https://bimcli.com
• MCP 列表主页：https://mcp.bimcli.com
• 功能架构：bim describe --json
• 问题反馈：https://github.com/HelloHowAreYouHaveANiceDay/bim-cli-plugin/issues