Hermes Architectural MCP

Открытый MCP-сервис, ориентированный на Docker, который преобразует существующие архитектурные планы в проверенную по размерам геометрию в миллиметрах, модели IFC и согласованные рендеры на CPU для Hermes Studio.

Что он гарантирует

Сервис разделяет визуальную интерпретацию и детерминированную геометрию. Он не экспортирует IFC и не рендерит проект, пока его явный PlanSpec не пройдёт проверки границ, ожидаемой площади, вложенности и пересечений.

Размеры из PDF рассматриваются только как кандидаты. Точная геометрия должна быть представлена в миллиметрах и проверена. Это предотвращает ситуацию, когда план на 100 м² подаётся как визуально увеличенный, но не подтверждённый по размерам проект.

Возможности

• просматривать векторные или растровые PDF-планы и формировать предварительный просмотр для рецензирования;

• обнаруживать кандидатов в размерные надписи, не доверяя им автоматически;

• проверять границы участка, помещения, общую площадь, вложенность и пересечения;

• экспортировать проверенные стены в IFC с помощью IfcOpenShell;

• собирать одну модель Blender и рендерить повторяемые виды интерьера/экстерьера на CPU;

• сохранять исходные файлы, отчёты, IFC, .blend и PNG-результаты;

• предоставлять инструменты через MCP Streamable HTTP по адресу /mcp.

Это ранняя инженерная версия. Она не заменяет проверку архитектурных, конструктивных, противопожарных, доступности и местных норм лицензированными специалистами.

Развёртывание с Dockhand

Предоставленный compose.yaml подключается к существующей внешней Docker-сети с именем proxy и не публикует порт на хосте.

1. Создайте или обновите стек Dockhand, используя compose.yaml.

2. Убедитесь, что сеть proxy уже существует.

3. Разверните стек.

4. Из другого контейнера в сети proxy проверьте:

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

5. В Hermes Studio добавьте HTTP MCP-сервер с:

http://architectural-mcp:8000/mcp

6. Импортируйте hermes-skill/SKILL.md как навык Hermes.

Контейнер хранит проекты в именованном томе architectural_projects.

Внутренняя загрузка PDF

Инструмент MCP принимает PDF в формате base64, но локальные файлы эффективнее загружать через внутреннюю Docker-сеть:

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'

В предоставленном стеке маршрут загрузки не публикуется на хосте.

Разработка

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

Инструменты MCP

• service_info

• analyze_plan_pdf

• create_or_update_plan

• validate_project

• export_project_ifc

• render_project_views

• list_project_outputs

См. examples/restaurant-100m2.json для описания структуры PlanSpec.

Публикация контейнеров

Пуш в main запускает тесты и публикует образы linux/amd64 в:

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

Лицензия

MIT