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 consistentes para Hermes Studio.
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 pase 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 m2 se presente como un diseño visualmente ampliado pero sin respaldo dimensional.
Related MCP server: WalkMyPlan MCP Server
inspeccionar planos PDF vectoriales o rasterizados y renderizar 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;
rechazar geometría solo visual y límites redimensionados meramente para coincidir con un área declarada;
exportar muros validados como IFC usando IfcOpenShell;
poner en cola trabajos de renderizado de Blender por CPU para que los renders largos no mantengan abierta la conexión MCP;
persistir archivos fuente, informes, IFC, .blend y salidas PNG;
exponer URLs de descarga internas para que Hermes pueda copiar los entregables en su espacio de trabajo;
exponer herramientas a través de MCP Streamable HTTP en /mcp.
Esta es una versión de ingeniería temprana. No reemplaza la revisión arquitectónica, estructural, de seguridad de vida, accesibilidad o código local por parte de profesionales licenciados.
El compose.yaml proporcionado se une a una red Docker externa existente llamada proxy y no publica un puerto de host.
Crear o actualizar un stack de Dockhand usando compose.yaml.
Confirmar que la red proxy ya existe.
Desplegar el stack.
Desde otro contenedor en proxy, verificar:
curl http://architectural-mcp:8000/healthEn Hermes Studio, añadir un servidor MCP HTTP con:
http://architectural-mcp:8000/mcpImportar hermes-skill/SKILL.md como una skill de Hermes.
El contenedor almacena proyectos en el volumen nombrado architectural_projects.
La herramienta MCP acepta PDFs en base64, pero los archivos locales se cargan de manera 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.
uv sync --extra dev
uv run ruff check src tests
uv run pytest -q
docker build -t hermes-architectural-mcp:local .service_info
analyze_plan_pdf
create_or_update_plan
validate_project
export_project_ifc
render_project_views
get_render_job
list_project_outputs
Ver examples/restaurant-100m2.json para la forma de PlanSpec.
Los pushes a main ejecutan pruebas y publican imágenes linux/amd64 en:
ghcr.io/twuijri/hermes-architectural-mcp:latestMIT
This server cannot be deployed
AI takeoff for construction: turn PDF blueprints into structured, traceable quantities.
Takeoffs, measured routes and schedules from construction drawings; PDF to CAD (DXF free, DWG $2).
Construction takeoff and estimating for AI agents. Measure a drawing PDF, export a priced estimate.
Fast multi-format CAD previews, geometry checks and conversion; measure and share in the workspace.
