bim-cli

bim-cli Claude Code プラグイン

bim-cli の Claude Code プラグインマニフェストです。ヘッドレスでの Revit エクスポート、PDF の一括エクスポート、洪水・敷地データの検索、オフラインの AEC タスクに対応します。Revit やデスクトップアプリを開かずに、AI アシスタントから実行できます。

Windows 専用です。 bim-cli は Windows 専用の CLI です。このプラグインを使用するには、bim-cli がインストールされた Windows マシンが必要です。

このプラグインの機能

インストール済みの bim-cli のすべての動詞を、Claude Code の 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）が含まれています。以下のものは含まれていません。

• プラグイン自体の実行可能コード
• 独自のテレメトリー
• シークレットや認証情報
• ネットワーク呼び出し

すべての処理はローカルで実行されます。このプラグインは、インストール済みの bim バイナリをローカルの stdio MCP サーバー（bim mcp）として起動する方法を Claude Code に伝えるだけです。クラウド上で実行されるものはありません。

セットアップ

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 を実行し、インストール済みのドライバーが正常であることを確認します。

エージェントスキル（Hermes、Claude Code、その他の Agent Skills ホスト向け）

skills/bim-cli/ は、エージェントがターミナルから bim を操作する方法を学ぶための Agent Skills スキルです。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]）で、bim-cli が PATH 上にあることを前提とします。インストーラー自体を実行することはなく、PowerShell のワンライナーをユーザーに提示します。

また、Agent Skills well-known エンドポイントとして bimcli.com からも提供されます。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>/ を編集し、フロントマターの 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（またはシェルへのパイプ）を絶対に含めないでください。これは厳格にブロックされます。
4. main にマージします。tap と bimcli.com にはすぐに反映されます。Hermes ユーザーは hermes skills update を実行すると利用できます。

プライバシーポリシー

bim-cli はすべてローカルマシン上で実行されます。MCP サーバー（bim mcp）は、bim-cli の各動詞自体が行う通信を除き、ネットワーク通信を行いません（例：洪水情報の検索では FEMA/NFHL の公開エンドポイントにアクセスします。PDF 操作ではネットワーク通信は一切行いません）。

マシンの外部に送信される情報：

• 任意の匿名テレメトリー：動詞の形式、bim のバージョン、OS、成功／エラーの種類、処理時間。 ファイルパス、住所、ドキュメントの内容、ユーザーの識別情報が送信されることはありません。 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