🏗️ ClaudeHopper - AI-Powered Construction Document Assistant

🏗️ ClaudeHopper - AI を活用した建設ドキュメントアシスタント

ClaudeHopper は、Claude やその他の LLM が、高度な RAG（検索拡張生成）とハイブリッド検索を通じて、建設ドキュメント、図面、仕様書を直接扱えるようにする、建設業界に特化した Model Context Protocol（MCP）サーバーです。建設図面について質問したり、特定の詳細を探したり、技術仕様を簡単に分析したりできます。

✨ 機能

• 🔍 CAD 図面、計画図、仕様書に最適化された、建設ドキュメント検索用のベクトルベース検索
• 🖼️ テキストによる説明に基づいて類似した図面を見つけるビジュアル検索
• 🏢 建設業界のドキュメント形式に特化したメタデータ抽出
• 📊 ドキュメントのインテリジェントなチャンク分割と分類による、効率的なトークン使用
• 🔒 ドキュメントのローカル保存と処理によるセキュリティ
• 📈 さまざまな図面の種類と建設分野（構造、土木、建築など）に対応

🚀 クイックスタート

前提条件

• Node.js 18+
• ローカル AI モデル用の Ollama
  • 必要なモデル：nomic-embed-text、phi4、clip
• Claude Desktop App
• 画像抽出用：Poppler Utils（pdfimages コマンド）

ワンクリックセットアップ

1. ClaudeHopper をダウンロードします
2. セットアップスクリプトを実行します：

cd ~/Desktop/claudehopper
chmod +x run_now_preserve.sh
./run_now_preserve.sh

これにより、以下が実行されます：

• 必要なディレクトリ構造を作成します
• 必要な AI モデルをインストールします
• 建設ドキュメントを処理します
• Claude Desktop App で ClaudeHopper を使用するよう設定します

ドキュメントの追加

建設ドキュメントを次のフォルダーに配置します：

• 図面：~/Desktop/PDFdrawings-MCP/InputDocs/Drawings/
• 仕様書：~/Desktop/PDFdrawings-MCP/InputDocs/TextDocs/

ドキュメントを追加した後、次を実行します：

./process_pdfdrawings.sh

🏗️ Claude で ClaudeHopper を使用する

Claude Desktop App で、次の質問例を試してみてください：

"What architectural drawings do we have for the project?"
"Show me the structural details for the foundation system"
"Find drawings that show a concrete foundation with dimensions"
"Search for lift station layout drawings"
"What are the specifications for interior paint?"
"Find all sections discussing fire protection systems"

🛠️ 技術アーキテクチャ

ClaudeHopper は、建設ドキュメントを処理するための多段階パイプラインを使用します：

1. ドキュメント分析：PDF ドキュメントの構造とコンテンツの種類を分析します
2. メタデータ抽出：プロジェクト情報、図面の種類、分野を AI の支援で抽出します
3. コンテンツのチャンク分割：文脈を維持できるよう、ドキュメントをインテリジェントに分割します
4. 画像抽出：PDF から図面画像を特定して抽出します
5. ベクトル埋め込み：テキストと画像の意味表現を作成します
6. データベース保存：ベクトル検索機能のために LanceDB にローカル保存します

👀 画像検索のテスト

画像検索機能をテストするには、付属のテストスクリプトを使用できます：

# Make the test script executable
chmod +x test_image_search.sh

# Run the test script
./test_image_search.sh

これにより、以下が実行されます：

• アプリケーションをビルドします
• 必要な依存関係（pdfimages など）を確認します
• 図面ディレクトリ内の画像をデータベースに登録します
• 画像検索に対して一連のテストクエリを実行します

個別のテストコマンドを実行することもできます：

# Run the test with the default database location
npm run test:image:verbose

# Run the test with a specific database location
node tools/test_image_search.js /path/to/your/database

📝 利用可能な検索ツール

ClaudeHopper は、次のような専門的な検索機能を提供します：

• catalog_search：プロジェクト、分野、図面の種類などでドキュメントを検索します
• chunks_search：ドキュメント内の特定のコンテンツを探します
• all_chunks_search：ドキュメントコレクション全体を検索します
• image_search：テキストによる説明との視覚的な類似性に基づいて図面を検索します

画像検索機能の使用例は、image_search_examples.md ファイルで確認できます。

📜 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。