Hermes Architectural MCP

오픈소스, Docker 우선 MCP 서비스로, 기존 건축 도면을 치수 검증된 밀리미터 지오메트리, IFC 모델, 그리고 Hermes Studio용 일관된 CPU 렌더링 뷰로 변환합니다.

보장하는 것

이 서비스는 시각적 해석과 결정적 지오메트리를 분리합니다. 명시적인 PlanSpec이 경계, 예상 면적, 포함 관계, 중첩 검사를 통과하기 전에는 IFC를 내보내거나 프로젝트를 렌더링하지 않습니다.

PDF 치수는 후보로만 취급됩니다. 정확한 지오메트리는 밀리미터 단위로 표현되고 검증되어야 합니다. 이를 통해 100m² 도면이 시각적으로 확대되었지만 치수상 근거가 없는 설계로 제시되는 것을 방지합니다.

기능

• 벡터 또는 래스터 PDF 도면을 검사하고 검토 미리보기를 렌더링합니다.

• 치수 텍스트 후보를 자동으로 신뢰하지 않고 감지합니다.

• 사이트 경계, 공간, 총 면적, 포함 관계, 중첩을 검증합니다.

• IfcOpenShell을 사용하여 검증된 벽을 IFC로 내보냅니다.

• 하나의 Blender 모델을 구축하고 CPU에서 반복 가능한 실내/실외 뷰를 렌더링합니다.

• 소스 파일, 보고서, IFC, .blend, PNG 출력물을 저장합니다.

• MCP Streamable HTTP /mcp를 통해 도구를 노출합니다.

이것은 초기 엔지니어링 릴리스입니다. 공인된 전문가의 건축, 구조, 생명 안전, 접근성 또는 지역 코드 검토를 대체하지 않습니다.

Dockhand로 배포

제공된 compose.yaml은 proxy라는 기존 외부 Docker 네트워크에 연결되며 호스트 포트를 게시하지 않습니다.

1. compose.yaml을 사용하여 Dockhand 스택을 생성하거나 업데이트합니다.

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 도구는 base64 PDF를 허용하지만, 로컬 파일은 내부 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

PlanSpec 형식은 examples/restaurant-100m2.json을 참조하세요.

컨테이너 게시

main에 푸시하면 테스트가 실행되고 linux/amd64 이미지가 다음 위치에 게시됩니다:

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

라이선스

MIT