Hermes Architectural MCP

既存の建築プランを、寸法検証済みのミリメートルジオメトリ、IFCモデル、およびHermes Studio向けの一貫したCPUレンダリングビューに変換する、オープンソースでDockerファーストのMCPサービスです。

保証内容

このサービスは、視覚的な解釈と決定的なジオメトリを分離します。明示的なPlanSpecが境界、期待面積、包含、および重複チェックを通過するまで、IFCのエクスポートやプロジェクトのレンダリングは行いません。

PDFの寸法は候補としてのみ扱われます。正確なジオメトリはミリメートルで表現され、検証される必要があります。これにより、100 m2のプランが、視覚的に拡大されただけで寸法的に裏付けのないデザインとして提示されることを防ぎます。

機能

• ベクターまたはラスターPDFプランを検査し、レビュー用プレビューをレンダリング;

• 寸法テキストの候補を自動的に信頼せずに検出;

• 敷地境界、スペース、総面積、包含、および重複を検証;

• 検証済みの壁をIfcOpenShellを使用してIFCとしてエクスポート;

• 1つのBlenderモデルを構築し、CPU上で再現可能な内観/外観ビューをレンダリング;

• ソースファイル、レポート、IFC、.blend、およびPNG出力を永続化;

• MCP Streamable HTTPの/mcpでツールを公開。

これは初期のエンジニアリングリリースです。建築、構造、生命安全、アクセシビリティ、または地域のコードに関する、有資格者によるレビューを置き換えるものではありません。

Dockhandでのデプロイ

提供されているcompose.yamlは、proxyという名前の既存の外部Dockerネットワークに参加し、ホストポートを公開しません。

1. compose.yamlを使用してDockhandスタックを作成または更新します。

2. proxyネットワークが既に存在することを確認します。

3. スタックをデプロイします。

4. proxy上の別のコンテナから、以下を確認します:

   curl http://architectural-mcp:8000/health

5. Hermes Studioで、以下のHTTP MCPサーバーを追加します:

   http://architectural-mcp:8000/mcp

6. hermes-skill/SKILL.mdをHermesスキルとしてインポートします。

コンテナはプロジェクトを名前付きボリュームarchitectural_projectsに保存します。

内部PDFアップロード

MCPツールはbase64 PDFを受け入れますが、ローカルファイルは内部Dockerネットワークを介してアップロードする方が効率的です:

curl --fail --silent --show-error \
  -H 'Content-Type: application/pdf' \
  --data-binary '@/workspace/plan.pdf' \
  'http://architectural-mcp:8000/api/projects/my-project/plan-pdf'

提供されたスタックでは、アップロードルートはホストに公開されません。

開発

uv sync --extra dev
uv run ruff check src tests
uv run pytest -q
docker build -t hermes-architectural-mcp:local .

MCPツール

• service_info

• analyze_plan_pdf

• create_or_update_plan

• validate_project

• export_project_ifc

• render_project_views

• list_project_outputs

PlanSpecの形状については、examples/restaurant-100m2.jsonを参照してください。

コンテナ公開

mainへのプッシュはテストを実行し、linux/amd64イメージを以下に公開します:

ghcr.io/twuijri/hermes-architectural-mcp:latest

ライセンス

MIT