Hermes Architectural MCP

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

保証されること

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

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

Related MCP server: WalkMyPlan MCP Server

機能

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

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

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

• 視覚のみのジオメトリや、記載された面積に合わせてリサイズされただけの境界を拒否;

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

• CPU Blenderレンダージョブをキューに入れ、長時間のレンダリングがMCP接続を占有しないようにする;

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

• 内部ダウンロードURLを公開し、Hermesが成果物をワークスペースにコピーできるようにする;

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

これは初期のエンジニアリングリリースです。建築、構造、生命安全、アクセシビリティ、または地域のコードに関するライセンス取得済み専門家によるレビューの代わりにはなりません。

Dockhandでデプロイ

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

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

• get_render_job

• list_project_outputs

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

コンテナ公開

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

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

ライセンス

MIT