Hermes Architectural MCP

Ein Open-Source-MCP-Dienst mit Docker-First-Ansatz, der vorhandene Architekturpläne in maßgeprüfte Millimeter-Geometrie, IFC-Modelle und konsistente CPU-gerenderte Ansichten für Hermes Studio umwandelt.

Was es garantiert

Der Dienst trennt visuelle Interpretation von deterministischer Geometrie. Er exportiert kein IFC und rendert kein Projekt, bis sein expliziter PlanSpec die Prüfungen für Grenzen, erwartete Fläche, Enthaltensein und Überlappungen besteht.

PDF-Maße werden nur als Kandidaten behandelt. Die exakte Geometrie muss in Millimetern dargestellt und validiert werden. Dies verhindert, dass ein 100 m2 Plan als visuell vergrößertes, aber maßlich nicht belegtes Design präsentiert wird.

Funktionen

• Vektor- oder Raster-PDF-Pläne prüfen und eine Vorschau zur Überprüfung rendern;

• Kandidaten für Maßtexte erkennen, ohne ihnen automatisch zu vertrauen;

• Grundstücksgrenzen, Räume, Gesamtfläche, Enthaltensein und Überlappungen validieren;

• validierte Wände als IFC mit IfcOpenShell exportieren;

• ein Blender-Modell erstellen und wiederholbare Innen-/Außenansichten auf der CPU rendern;

• Quelldateien, Berichte, IFC, .blend- und PNG-Ausgaben speichern;

• Werkzeuge über MCP Streamable HTTP unter /mcp bereitstellen.

Dies ist eine frühe technische Version. Sie ersetzt nicht die Prüfung durch lizenzierte Fachleute in den Bereichen Architektur, Statik, Lebenssicherheit, Barrierefreiheit oder örtliche Bauvorschriften.

Bereitstellung mit Dockhand

Die bereitgestellte compose.yaml tritt einem vorhandenen externen Docker-Netzwerk namens proxy bei und veröffentlicht keinen Host-Port.

1. Erstellen oder aktualisieren Sie einen Dockhand-Stack mit compose.yaml.

2. Stellen Sie sicher, dass das Netzwerk proxy bereits existiert.

3. Stellen Sie den Stack bereit.

4. Überprüfen Sie von einem anderen Container im Netzwerk proxy aus:

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

5. Fügen Sie in Hermes Studio einen HTTP-MCP-Server hinzu mit:

   http://architectural-mcp:8000/mcp

6. Importieren Sie hermes-skill/SKILL.md als Hermes-Fähigkeit.

Der Container speichert Projekte im benannten Volume architectural_projects.

Interner PDF-Upload

Das MCP-Tool akzeptiert Base64-PDFs, aber lokale Dateien werden effizienter über das interne Docker-Netzwerk hochgeladen:

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'

In der bereitgestellten Stack-Konfiguration wird keine Upload-Route auf dem Host veröffentlicht.

Entwicklung

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

MCP-Werkzeuge

• service_info

• analyze_plan_pdf

• create_or_update_plan

• validate_project

• export_project_ifc

• render_project_views

• list_project_outputs

Siehe examples/restaurant-100m2.json für die Form des PlanSpec.

Container-Veröffentlichung

Pushes auf main führen Tests aus und veröffentlichen linux/amd64-Images auf:

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

Lizenz

MIT