Hermes Architectural MCP

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

Was er garantiert

Der Dienst trennt die visuelle Interpretation von der deterministischen Geometrie. Er exportiert kein IFC und rendert kein Projekt, bis seine explizite PlanSpec die Grenz-, Erwartungsflächen-, Enthaltenseins- und Überlappungsprüfungen bestanden hat.

PDF-Maße werden nur als Kandidaten behandelt. Exakte Geometrie muss in Millimetern dargestellt und validiert werden. Dadurch wird verhindert, dass ein 100-m2-Plan als optisch vergrößerter, aber maßlich nicht abgesicherter Entwurf präsentiert wird.

Related MCP server: WalkMyPlan MCP Server

Funktionen

• Vektor- oder Raster-PDF-Pläne untersuchen und eine Überprüfungsvorschau rendern;

• Dimensionstext-Kandidaten erkennen, ohne ihnen automatisch zu vertrauen;

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

• rein visuelle Geometrie und Grenzen ablehnen, die lediglich angepasst wurden, um einer angegebenen Fläche zu entsprechen;

• validierte Wände mit IfcOpenShell als IFC exportieren;

• CPU-Blender-Renderaufträge in die Warteschlange stellen, damit lange Renderings die MCP-Verbindung nicht offenhalten;

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

• interne Download-URLs bereitstellen, damit Hermes Ergebnisse in seinen Arbeitsbereich kopieren kann;

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

Dies ist eine frühe technische Veröffentlichung. Sie ersetzt nicht die Prüfung der Architektur, Statik, Lebenssicherheit, Barrierefreiheit oder lokalen Bauvorschriften durch lizenzierte Fachleute.

Mit Dockhand bereitstellen

Die mitgelieferte compose.yaml tritt einem bestehenden 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. Führen Sie von einem anderen Container im Netzwerk proxy die folgende Überprüfung 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-Skill.

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'

Im mitgelieferten Stack 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-Tools

• service_info

• analyze_plan_pdf

• create_or_update_plan

• validate_project

• export_project_ifc

• render_project_views

• get_render_job

• list_project_outputs

Siehe examples/restaurant-100m2.json für die Struktur der PlanSpec.

Container-Veröffentlichung

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

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

Lizenz

MIT