hermes-architectural-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Hermes Architectural MCP
An open-source, Docker-first MCP service that converts existing architectural plans into dimension-verified millimetre geometry, IFC models, and consistent CPU-rendered views for Hermes Studio.
What it guarantees
The service separates visual interpretation from deterministic geometry. It will not export IFC or render a project until its explicit PlanSpec passes boundary, expected-area, containment, and overlap checks.
PDF dimensions are treated as candidates only. Exact geometry must be represented in millimetres and validated. This prevents a 100 m2 plan from being presented as a visually enlarged but dimensionally unsupported design.
Related MCP server: pdf-parse-mcp
Capabilities
inspect vector or raster PDF plans and render a review preview;
detect dimension text candidates without trusting them automatically;
validate site boundaries, spaces, total area, containment, and overlaps;
reject visual-only geometry and boundaries resized merely to match a stated area;
export validated walls as IFC using IfcOpenShell;
queue CPU Blender render jobs so long renders do not hold the MCP connection open;
persist source files, reports, IFC,
.blend, and PNG outputs;expose internal download URLs so Hermes can copy deliverables into its workspace;
expose tools through MCP Streamable HTTP at
/mcp.
This is an early engineering release. It does not replace architectural, structural, life-safety, accessibility, or local-code review by licensed professionals.
Deploy with Dockhand
The provided compose.yaml joins an existing external Docker network named proxy and does not publish a host port.
Create or update a Dockhand stack using
compose.yaml.Confirm the
proxynetwork already exists.Deploy the stack.
From another container on
proxy, verify:curl http://architectural-mcp:8000/healthIn Hermes Studio, add an HTTP MCP server with:
http://architectural-mcp:8000/mcpImport
hermes-skill/SKILL.mdas a Hermes skill.
The container stores projects in the named volume architectural_projects.
Internal PDF upload
The MCP tool accepts base64 PDFs, but local files are more efficiently uploaded over the internal Docker network:
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 upload route is published to the host in the supplied stack.
Development
uv sync --extra dev
uv run ruff check src tests
uv run pytest -q
docker build -t hermes-architectural-mcp:local .MCP tools
service_infoanalyze_plan_pdfcreate_or_update_planvalidate_projectexport_project_ifcrender_project_viewsget_render_joblist_project_outputs
See examples/restaurant-100m2.json for the PlanSpec shape.
Container publishing
Pushes to main run tests and publish linux/amd64 images to:
ghcr.io/twuijri/hermes-architectural-mcp:latestLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Check floor-plan images, trace them into editable plans, export PDF and IFC, and query IFC models.
Quantity takeoff from PDF drawings and BIM/IFC: room areas, symbol counts, roof zones.
AI takeoff for construction: turn PDF blueprints into structured, traceable quantities.
Read, query, edit and render DWG drawings with AI. No AutoCAD required.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables users to create and edit 3D floor plans conversationally, describing rooms and layouts or uploading DWG/PDF drawings, then view them in 2D/3D via a live link.4MIT
- AlicenseAqualityCmaintenanceEnables precise extraction of PDF content, including text coordinates, vector shapes, images, and on-demand raster rendering, for use cases like reconstructing design files.325 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to automate 2D architectural drafting and CAD file management, including DXF/DWG parsing, SVG/PNG/PDF rendering, wall extrusion to 3D STL meshes, room and beam analysis, block/script library access, and persistent depot storage via a REST API and MCP tools.18MIT
- AlicenseAqualityCmaintenanceConverts documents among PDF, DOCX, Markdown, plain text, and images while returning fidelity reports that clearly distinguish PASS, FAIL, NOT_CHECKED, and UNSUPPORTED outcomes. Also enables lossless reading, exact search, and structured extraction from long documents without treating unchecked content as passed.16AGPL 3.0