Claudehopper

🚀 🏗️ ClaudeHopper - AI 搭載の建築ドキュメントアシスタント

ClaudeHopper は、専用の Model Context Protocol (MCP) サーバーです。Claude やその他の大規模言語モデルが建築図面、ドキュメント、仕様書と直接やり取りできるようにし、高度な RAG（検索強化生成）とハイブリッド検索により、効率的なドキュメント検索を実現します。建築図面に関する質問を簡単に行い、特定の詳細情報を見つけ、技術仕様を分析することができます。

✨ 主な機能

• 🔍 ベクトルベースの検索により、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 Desktop App で以下のサンプル質問を試してみてください。

「私たちが持っている建築図面は何ですか？」
「基礎システムの構造詳細を表示してください。」
「コンクリート基礎とその寸法を示す図面を探してください。」
「給排水ステーションのレイアウト図を検索してください。」
「建築用塗料の仕様は何ですか？」
「防火システムについて議論しているすべての内容を探してください。」

🔧 技術詳細

ClaudeHopper は、建築ドキュメントを多段階のパイプラインで処理します。

1. ドキュメント分析：PDF ドキュメントの構造と内容タイプを分析します。
2. メタデータ抽出：AI を利用して、プロジェクト情報、図面タイプ、分野を抽出します。
3. 内容分割：スマートなドキュメント分割と分類を行います。
4. 画像前処理：AI モデルで処理するのに適した画像品質に最適化します。
5. モデル推論：Claude を使用してコンテキストを理解します。

💻 使用例

画像検索機能をテストするには、以下のコマンドを実行します。

python test_image_search.py

必要な依存関係がインストールされていることを確認し、スクリプト内の説明に従って操作してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で保護されています。