RackArchitect MCP

---

🎯 RackArchitect MCPを選ぶ理由（3つの黄金律）

AIエージェントでコンパクトな10インチミニラック（例：DeskPi RackMate T1/T2、Digitus SOHO）や高密度な19インチホームラボを設計しようとしても、これまではある理由で失敗していました。LLMは物理的な形状を幻覚します。 背面PDUの55 mmのSchukoプラグが前面に取り付けた182 mmのLenovo ThinkCentre M920qにぶつかることや、ファンレスPoEスイッチを2台重ねると熱だまりが生じることを見落とすのです。

RackArchitect MCPは、次の3つの妥協できないエンジニアリングの法則でこの問題を解決します。

1. LLMに形状を推測させません： すべての空間座標（1 U = 44.45 mm）、3D軸平行境界ボックス（B_chassisと動的プラグクリアランス$\Delta Z_{\text{plug}}$）、Catmull-Rom 3Dケーブルスプライン、PoE予算DAG、対数方式のdB(A)音響合算を、@rack-mcp/core-domainがミリメートル単位で決定論的に計算します。
2. 単一の信頼できる情報源（rack.yaml）： デバイス、3Dプリント用のsub-Uキャリアスロット、子ミニPC、キーストーンカプラー、ケーブル、VLAN、IP CIDRを含むラック全体の状態を、Gitで扱いやすい単一のYAMLファイルに保存します。
3. 実行可能な自己修正フィードバック： 配置やケーブルが5つの検証段階のいずれか（26種類の閉じたDiagnosticCode型）で失敗すると、エンジンは構造化されたremediation_suggestionsを返します。これにより、AIエージェントは次のターンで衝突、PoE過負荷、Cat5eのボトルネックを自律的に修正できます。

---

🖼️ 生成CAD設計図（出力SVGは100%決定論的）

1. 2列の設計用立面図とZ深度側面断面図（elevation.svg）

機器一覧、正面立面図（X, Y）、水平方向に鏡像反転した背面立面図（W_panel - X - width）、ケーブル注記レーン、右側のZ深度断面図（Z_minからZ_maxまで。前面ガラスドアのクリアランスチェックは-50 mm、背面壁のクリアランスチェックは+300 mm）を含みます。

2. VLANおよびIP CIDRバッジ付きの5層論理ピン間配線図（wiring-schematic.svg）

---

🚀 30秒クイックスタート

オプション A：ローカルの Node.js（>= 20）と pnpm

# 1. Clone & install
git clone https://github.com/itAlex240/rack-architect-mcp.git
cd rack-architect-mcp
pnpm install

# 2. Build all 6 packages & run the 34 test suites
pnpm build
pnpm test

# 3. Launch the Live 3D/2D Web-Viewer & Sidecar on the 8U 10-Inch Reference Homelab
pnpm start

ブラウザーで http://127.0.0.1:3100/ を開くと、3Dデジタルツインを確認したり、カタログドロワーからデバイスを設置したり、3Dスプラインケーブルを配線したり、.SCAD / .STL / .GLB / .SVG / BOM.md の成果物をダウンロードしたりできます！

オプション B：Docker（ローカル依存関係なし）

# Run the pre-built image from GitHub Container Registry:
docker run --rm -p 3100:3100 ghcr.io/italex240/rack-architect-mcp:latest

# Or build locally:
docker build -t rack-architect-mcp .
docker run --rm -p 3100:3100 rack-architect-mcp
# Open http://127.0.0.1:3100/

オプション C：CLI による検証とヘッドレス CAD エクスポート

# Validate any rack.yaml and print the ASCII Elevation Plan + Diagnostics
pnpm validate:demo

# Export elevation.svg, wiring-schematic.svg, BOM.md, rack-scene.glb, and all .scad + .stl 3D-print carriers
pnpm export:demo

---

🤖 Claude Desktop、Cursor、または Antigravity を接続する

rack_architect_mcp を claude_desktop_config.json、.cursor/mcp.json、または Antigravity の MCP 設定に追加します。

{
  "mcpServers": {
    "rack_architect_mcp": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/rack-architect-mcp/packages/cli/dist/bin.js",
        "--stdio",
        "--port",
        "3100",
        "--project",
        "/ABSOLUTE/PATH/TO/rack-architect-mcp/examples/10inch-homelab/rack.yaml"
      ]
    }
  }
}

AI エージェントが stdio 経由で MCP サーバーを起動するたびに、ローカルの WebSocket Sidecar が http://127.0.0.1:3100 で自動的に起動します。AI が実行するツール呼び出し（mount_equipment、connect_cables、modify_equipment、undo_redo）はすべて、3D ブラウザービューにリアルタイムで反映されます！

🧠 公式オープンソースのエージェントスキル（skills/rack-architect/SKILL.md）

このリポジトリには、完全無料の MIT ライセンスのエージェントスキル（skills/rack-architect/SKILL.md および .agents/skills/rack-architect/SKILL.md）が含まれています。このスキルにより、Claude Code、Cursor、GitHub Copilot、Google Antigravity は、6 フェーズの自律型ラックエンジニアリング手順書（サブUモジュラーキャリアの組み合わせ、-angled プラグの選択、26 種類すべての診断修正パターン、2マニフォールドの .STL エクスポート）を習得できます。

# Install the skill into Claude Code, Cursor, Copilot, or Windsurf via skills CLI:
npx skills add itAlex240/rack-architect-mcp

# Or in Google Antigravity: automatically discovered from .agents/skills/rack-architect/SKILL.md!

---

🖨️ パラメトリックな3Dプリント生成ツール（.scad と .stl）

すべてのモジュラー3Dプリント用キャリア（category: 'modular-carrier'）について、@rack-mcp/exporters が次のファイルを自動生成します。

1. パラメトリック OpenSCAD（.scad）： 壁厚、EIA-310 楕円ラックイヤー（9.5 × 6.5 mm）、サブUデバイスベイ（Lenovo ThinkCentre M920q、Ubiquiti UCG-Max、JetKVM 向けの許容差 +0.35 mm）、Keystone スナップインクリップ、側面サポートレール、Velcro スロット付き背面 PSU ブリッククレードルをカスタマイズできます。
2. スライス可能な、水密性のある ASCII .stl： 2D グリッド分割によってメモリ上で直接計算され、OrcaSlicer、Bambu Studio、または PrusaSlicer にそのまま読み込めます！

事前生成された参照ファイルは examples/10inch-homelab/ にあります。

• 3dprint-10inch-lenovo-tiny-plus-2keystone.scad および .stl
• 3dprint-10inch-ucg-ultra-plus-3keystone.scad および .stl
• 3dprint-10inch-cover-panel-lines-1u.scad および .stl
• 3dprint-10inch-cover-panel-hex-1u.scad および .stl
• 3dprint-10inch-cover-panel-lines-2u.scad および .stl
• 3dprint-10inch-cover-panel-ribs-2u.scad および .stl

---

🖥️ ライブ 3D デジタルツイン＆2D CAD Web ビューアー（127.0.0.1:3100）

• インタラクティブなカタログ＆ケーブルパッチビルダー（+ Catalog & Cable Builder）：
  • 67 種類すべてのハードウェア設計図を検索し、10inch／19inch／6inch／sub-module で絞り込み、Target U と FRONT/REAR を選択して、ワンクリックで取り付けます。
  • 任意の 2 つのポート間に 3D Catmull-Rom ケーブルを配線し、必要に応じて VLAN ID（1..4094）および IP CIDR（10.10.20.0/24）の注釈を追加します。
• 3D エンジニアリング HUD：
  • カメラプリセット：Perspective、Front Ortho、Rear Ortho、Left Cutaway
  • 切り替え：X-Ray Chassis（内部のミニ PC と PSU ブリックを点検）、Clearance Boxes（$\Delta Z_{\text{plug}}$ のワイヤーフレーム）、Cable Splines
  • 前面アセンブリと背面アセンブリを分離する Explode Z (0..140 mm) スライダー
• W3C WebMCP 対応： WebMCP 対応ブラウザーで開くと、document.modelContext に 11 個すべてのツールを自動登録します。

---

🛡️ 5 段階の検証エンジン（診断コード全 26 種類）

Stage	Diagnostic Codes	What Is Checked Deterministically?
1. 範囲とスロット	CODE_DUPLICATE_INSTANCE_ID、CODE_UNKNOWN_BLUEPRINT、CODE_RACK_BOUNDS_EXCEEDED、CODE_SLOT_NOT_FOUND、CODE_SLOT_OCCUPIED、CODE_SLOT_BOUNDS_EXCEEDED	ラックの U 高さ、パネル幅（19"、10"、6"）、サブ U キャリアスロットの寸法（mm）および許可されるカテゴリ。
2. 3D AABB とドア	CODE_CHASSIS_COLLISION、CODE_CLEARANCE_COLLISION、CODE_FRONT_DOOR_VIOLATION、CODE_REAR_CLEARANCE_VIOLATION	前面および背面の機器間におけるミリメートル単位で正確な 3D AABB の重なり。動的なプラグのクリアランス（schuko-cee7 = 55 mm、iec-c13 = 45 mm、sfp+ = 38 mm、rj45 = 35 mm）も含みます。
3. 電源と PoE DAG	CODE_POE_BUDGET_EXCEEDED、CODE_MISSING_POWER_INPUT、CODE_EXTERNAL_PSU_UNPLUGGED、CODE_PDU_OVERLOAD	UPS/PDU からスイッチ、外部電源ブリック（Lenovo 135W Slim-Tip）、PoE PSE/PD バジェット（196 W）に至るまでの電気系統 DAG 全体。
4. ケーブルと速度	CODE_PORT_NOT_FOUND、CODE_PORT_ALREADY_OCCUPIED、CODE_PORT_INCOMPATIBLE、SPEED_MISMATCH、CODE_MISSING_CABLE_PORTAL、CODE_CABLE_BEND_RADIUS_VIOLATION	コネクターの互換性、$\ge 2.5\text{ GbE}$ リンク上の Cat5e ボトルネック検出（SPEED_MISMATCH）、前面から背面へのブラシポータルの検査、および 3D スプラインの最小曲げ半径。
5. 熱と音響	THERMAL_AIRFLOW_CONFLICT、THERMAL_HOTSPOT_STACKING、CODE_THERMAL_DENSITY_HIGH、ACOUSTIC_NOISE_HIGH、CODE_WEIGHT_LIMIT_WARNING	反対方向のエアフロー（front-to-rear と rear-to-front）、高出力ファンレススイッチの積み重ね、BTU/hr 単位の発熱量、および対数方式による dB(A) 騒音の合算（$L_{\text{total}} = 10 \log_{10}(\sum 10^{L_i/10})$）。

---

📦 モノレポのアーキテクチャ（packages/*）

Package	Description
@rack-mcp/core-domain	純粋な TypeScript/Zod スキーマ、3D 座標変換器、AABB 衝突ソルバー、5 段階バリデーター、およびクランプ付き Catmull-Rom 3D スプラインルーター（Node/DOM 依存関係なし）。
@rack-mcp/hardware-catalog	67 種類の YAML ハードウェア設計図（10inch、19inch、6inch、carriers、sub-modules）、port_groups マトリックス展開ツール、およびカタログ検索／バリデーター。
@rack-mcp/exporters	elevation.svg、wiring-schematic.svg、BOM.md、ヘッドレスバイナリ .glb、およびパラメトリックな .scad と .stl の 3D プリント生成ツール。
@rack-mcp/mcp-server	MCP サーバー（stdio）、11 個のツール、4 個のリソース、2 個のプロンプト、50 ステップの Undo/Redo マネージャー、およびローカル HTTP/WebSocket サイドカー（:3100）。
@rack-mcp/web-viewer	React 19 + Three.js（@react-three/fiber）によるライブ 3D/2D CAD スタジオ、カタログ／ケーブルビルダーのドロワー、および W3C WebMCP 統合。
@rack-mcp/cli	統合された rack-mcp CLI（serve、validate、export）。

---

🤝 コントリビュートとハードウェアの設計図の追加

お気に入りの10インチスイッチ、ミニPC、または3Dプリント製キャリアを追加しませんか？ 2分もかからずに新しいYAML設計図を追加できます。CONTRIBUTING.mdをご覧ください！

📄 ライセンス

MIT Licenseのもとで公開されています。