Hermes Architectural MCP

Un servicio MCP de código abierto, Docker-first, que convierte planos arquitectónicos existentes en geometría milimétrica verificada dimensionalmente, modelos IFC y vistas renderizadas por CPU coherentes para Hermes Studio.

Lo que garantiza

El servicio separa la interpretación visual de la geometría determinista. No exportará IFC ni renderizará un proyecto hasta que su PlanSpec explícito supere las comprobaciones de límites, área esperada, contención y solapamiento.

Las dimensiones del PDF se tratan solo como candidatas. La geometría exacta debe representarse en milímetros y validarse. Esto evita que un plano de 100 m² se presente como un diseño visualmente ampliado pero dimensionalmente no respaldado.

Capacidades

• inspeccionar planos PDF vectoriales o rasterizados y generar una vista previa de revisión;

• detectar candidatos de texto de dimensiones sin confiar en ellos automáticamente;

• validar límites del sitio, espacios, área total, contención y solapamientos;

• exportar muros validados como IFC usando IfcOpenShell;

• construir un modelo de Blender y renderizar vistas interiores/exteriores repetibles en CPU;

• persistir archivos fuente, informes, IFC, .blend y salidas PNG;

• exponer herramientas a través de MCP Streamable HTTP en /mcp.

Esta es una versión de ingeniería temprana. No sustituye la revisión arquitectónica, estructural, de seguridad contra incendios, de accesibilidad o de código local por parte de profesionales autorizados.

Despliegue con Dockhand

El compose.yaml proporcionado se une a una red Docker externa existente llamada proxy y no publica un puerto de host.

1. Cree o actualice un stack de Dockhand usando compose.yaml.

2. Confirme que la red proxy ya existe.

3. Despliegue el stack.

4. Desde otro contenedor en proxy, verifique:

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

5. En Hermes Studio, añada un servidor MCP HTTP con:

http://architectural-mcp:8000/mcp

6. Importe hermes-skill/SKILL.md como una skill de Hermes.

El contenedor almacena los proyectos en el volumen nombrado architectural_projects.

Carga interna de PDF

La herramienta MCP acepta PDFs en base64, pero los archivos locales se cargan de forma más eficiente a través de la red Docker interna:

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'

No se publica ninguna ruta de carga al host en el stack suministrado.

Desarrollo

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

Herramientas MCP

• service_info

• analyze_plan_pdf

• create_or_update_plan

• validate_project

• export_project_ifc

• render_project_views

• list_project_outputs

Consulte examples/restaurant-100m2.json para ver la forma de PlanSpec.

Publicación de contenedores

Los envíos a main ejecutan pruebas y publican imágenes linux/amd64 en:

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

Licencia

MIT