Claudehopper (Construction Document Analysis)

🚀 ClaudeHopper - AI搭載の建設文書アシスタント

ClaudeHopperは、Claudeやその他の大規模言語モデル（LLMs）が建築図面、文書、規格と直接やり取りできるようにする、専用のモデルコンテキストプロトコル（MCP）サーバーです。高度な検索ベースの拡張生成（RAG）とハイブリッド検索機能を通じて、施工図に関する質問を簡単に行い、特定の詳細を検索し、技術規格を分析することができます。

✨ 主な機能

• 🔍 建築図面、計画、規格に最適化されたベクトルベースの検索
• 🖼️ テキスト記述に基づく画像検索で、類似の図面を探すことができます
• 🏢 建築業界の文書形式に特化したメタデータ抽出機能を提供
• 📊 スマートなファイル分割による効率的なトークン使用
• 🔒 ローカルでの保存と処理によるセキュリティ確保
• 📈 さまざまな図面タイプと建築分野（構造、土木、建築など）をサポート

🚀 クイックスタート

前提条件

• Node.js 18+
• Ollama、ローカルAIモデル用
  • 必要なモデル：nomic-embed-text, phi4, clip
• Claudeデスクトップアプリケーション
• 画像抽出（オプション）：Poppler Utils (pdfimagesコマンド)

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

1. ClaudeHopperをダウンロードします。
2. インストールスクリプトを実行します。

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

この操作により、以下のことが行われます。

• 必要なディレクトリ構造が作成されます。
• 必要なAIモデルがインストールされます。
• 建築図面が処理されます。
• ClaudeデスクトップアプリケーションがClaudeHopperを使用するように設定されます。

文書の追加

建築文書を以下のフォルダに配置します。

• 図面：~/Desktop/PDFdrawings-MCP/InputDocs/Drawings/
• 規格：~/Desktop/PDFdrawings-MCP/InputDocs/TextDocs/

文書を追加した後、以下を実行します。

./process_pdfdrawings.sh

💻 使用例

基本的な使用法

Claudeデスクトップアプリケーションで以下のサンプル質問を試してみてください。

「このプロジェクトに使用されている建築図面は何ですか？」
「基礎システムの構造詳細を表示してください」
「コンクリート基礎とその寸法を示す図面を探してください」
「揚水場のレイアウト図を検索してください」
「Interior paint（室内塗装）の規格は何ですか？」
「防火システムについて議論されているすべての内容を探してください」

🔧 技術詳細

技術アーキテクチャ

ClaudeHopperは、建築文書を処理するために多段階のパイプラインを使用しています。

1. 文書分析：PDF文書の構造と内容タイプを分析します。
2. メタデータ抽出：AIを利用して文書からプロジェクト情報、図面タイプ、分野を抽出します。
3. 内容分割：コンテキストを維持するために文書をスマートに分割します。
4. 画像抽出：PDF内の図面画像を識別して抽出します。
5. ベクトル埋め込み：テキストと画像の意味表現を作成します。
6. データベース保存：データをデータベースに保存します。

データベースの説明

• テーブル構造：
  • documents テーブル：文書の基本情報（ファイル名、内容要約など）を保存します。
  • metadata テーブル：抽出されたメタデータ情報（作者、日付など）を保存します。
  • vectors テーブル：類似性検索用のベクトル表現を保存します。

📄 ライセンス

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

⚠️ 重要提示

すべての必要な依存関係（Node.jsやOllamaなど）をインストールしてください。大量の文書を処理する場合は、パフォーマンス向上のためにハードウェア構成を最適化することをおすすめします。さらなるサポートやカスタマイズが必要な場合は、プロジェクトのドキュメントを参照するか、メンテナンスチームにお問い合わせください。

ClaudeHopperをご利用いただきありがとうございます。さらなるヘルプが必要な場合は、ドキュメントを参照するか、お問い合わせください。