Diy Helper MCP Servers

🚀 DIY Helper MCP Servers

DIY Helperプラットフォーム用のモデルコンテキストプロトコル（MCP）サーバーです。建築コードの検索、材料仕様の参照、メーカーガイドのアクセスを提供し、リアルタイムの相談サポートを行います。

🚀 クイックスタート

このDIY Helper MCP Serversを使用することで、住宅建築コードや材料仕様に関する情報をリアルタイムで取得できます。以下のセクションで各サーバーの詳細や使用方法を説明します。

✨ 主な機能

• 住宅建築コードの参照：NEC、IRC、IPCなどの建築コードにアクセスできます。
• 材料の検索と計算：材料の検索、価格の確認、必要数量の計算が可能です。
• ツールの提供：自然言語によるコード検索や、特定のコードセクションの取得などのツールが用意されています。

📦 インストール

前提条件

• Python 3.8以上
• pip

セットアップ

1. リポジトリをクローンします。

git clone https://github.com/yourusername/diy-helper-mcp-servers.git
cd diy-helper-mcp-servers

2. 仮想環境を作成します。

python -m venv venv
source venv/bin/activate  # Windowsの場合は: venv\Scripts\activate

3. 依存関係をインストールします。

pip install -r requirements.txt

4. 環境を設定します。

cp .env.example .env
# .envを編集し、APIキーを追加します

💻 使用例

建築コードサーバーの起動

python src/building_codes_server/server.py

Claude Desktopとの連携

Claude Desktopの設定ファイル (claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "building-codes": {
      "command": "python",
      "args": ["/path/to/diy-helper-mcp-servers/src/building_codes_server/server.py"],
      "env": {
        "CODE_DATABASE_PATH": "/path/to/codes.json"
      }
    }
  }
}

プログラムからの使用

from anthropic import Anthropic
from mcp import ClientSession, StdioServerParameters

# MCPクライアントを初期化します
server_params = StdioServerParameters(
    command="python",
    args=["src/building_codes_server/server.py"]
)

async with ClientSession(server_params) as session:
    # 接続を初期化します
    await session.initialize()
    
    # 利用可能なツールをリストします
    tools = await session.list_tools()
    
    # ツールを呼び出します
    result = await session.call_tool(
        "search_building_codes",
        {"query": "outlet spacing in living room", "jurisdiction": "National"}
    )
    print(result)

📚 ドキュメント

サーバー

建築コードサーバー

住宅建築コードへのアクセスを提供します。以下のコードが含まれます。

• NEC（National Electrical Code）
• IRC（International Residential Code）
• IPC（International Plumbing Code）

ツール:

• search_building_codes - 自然言語によるコード検索
• get_code_section - 特定のコードセクションを取得
• check_code_compliance - シナリオのコード遵守を検証
• list_code_categories - 利用可能なコードを閲覧

材料仕様サーバー

リアルタイムの材料検索、価格、数量計算を提供します。

ツール:

• search_materials - サプライヤーをまたいだ製品検索
• get_product_details - 詳細な製品仕様を取得
• find_alternatives - 異なる価格帯の類似製品を検索
• check_compatibility - 製品の互換性を検証
• calculate_wire_needed - 電気配線の必要数量を計算
• calculate_outlets_needed - NECに基づくコンセントの必要数量を計算
• calculate_tile_needed - タイルの必要数量を計算
• calculate_paint_needed - 塗料の必要数量を計算
• calculate_deck_lumber - デッキの枠組み材料を計算
• calculate_pex_pipe - 配管の必要数量を計算
• create_shopping_list - 完全なショッピングリストを生成

実行方法:

python src/material_specs_server/server.py

新しいコードの追加

src/building_codes_server/codes.jsonを編集します。

{
  "id": "unique-id",
  "code_ref": "CODE SECTION",
  "title": "Code Title",
  "category": "electrical|plumbing|structural|mechanical|general",
  "jurisdiction": "National|State|City",
  "summary": "Plain English summary",
  "source": "Official source citation",
  "common_questions": ["question 1", "question 2"],
  "notes": "Additional context",
  "related_codes": ["RELATED-1", "RELATED-2"]
}

テストの実行

すべてのテストを実行

# すべてのテストを実行
./run_all_tests.sh

# または個別に実行:
python tests/test_building_codes.py
python tests/test_material_server.py

テストカバレッジ

建築コードサーバー:

• ✓ コード検索機能
• ✓ 特定のセクションの取得
• ✓ カテゴリのリスト表示
• ✓ 一般的なDIYの質問
• ✓ 管轄区域のフィルタリング
• ✓ エッジケースの処理

材料仕様サーバー:

• ✓ 製品検索
• ✓ 製品詳細
• ✓ 材料計算機（7種類）
• ✓ 代替製品
• ✓ 互換性チェック
• ✓ ショッピングリストの生成

クイックテスト

# 建築コードサーバーを直接テスト
python src/building_codes_server/server.py

# 材料仕様サーバーを直接テスト
python src/material_specs_server/server.py

ウェブテストインターフェイス

LinuxでまたはClaude Desktopなしでテストする場合は、ウェブインターフェイスを使用します。

前提条件

# Flaskをインストール
pip install flask

# Anthropic APIキーを設定
export ANTHROPIC_API_KEY='your-key-here'

ウェブインターフェイスを実行

python test_web_interface.py

その後、ブラウザで以下のURLを開きます。http://localhost:5000

機能

• Claude + MCPツールとの対話型チャット
• リアルタイムの建築コード検索
• 材料検索と価格確認
• プロジェクト計算機
• 完全な会話履歴
• 始めるためのサンプルクエリ

サンプルクエリ

ウェブインターフェイスで以下のクエリを試してみてください。

• "What are the outlet spacing requirements for a kitchen?"
• "Search for 12 gauge wire and show me prices"
• "Calculate how much wire I need for a 40-foot circuit"
• "I'm installing a dishwasher 30 feet from the panel. What do I need?"

🔮 ロードマップ

• [ ] ベクトル検索の統合（Pinecone/pgvector）
• [ ] 材料仕様サーバー
• [ ] メーカーガイドサーバー
• [ ] 管轄区域のコード改正
• [ ] コード遵守のための画像分析
• [ ] コスト推定ツール

🤝 コントリビュート

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

🛠️ サポート

• ドキュメント: docs/setup.md
• 問題報告: https://github.com/yourusername/diy-helper-mcp-servers/issues
• メール: support@yourplatform.com