Hermes Architectural MCP

기존 건축 도면을 치수 검증된 밀리미터 단위 지오메트리, IFC 모델, 일관된 CPU 렌더링 뷰로 변환하여 Hermes Studio에 제공하는 오픈소스, Docker 우선 MCP 서비스입니다.

보장 사항

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

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

Related MCP server: WalkMyPlan MCP Server

기능

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

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

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

• 명시된 면적에 맞추기만 한 시각 전용 지오메트리와 경계를 거부합니다.

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

• 오래 걸리는 렌더링이 MCP 연결을 계속 열어 두지 않도록 CPU Blender 렌더 작업을 대기열에 넣습니다.

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

• Hermes가 산출물을 자체 워크스페이스로 복사할 수 있도록 내부 다운로드 URL을 제공합니다.

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

이것은 초기 엔지니어링 릴리스입니다. 자격을 갖춘 전문가의 건축, 구조, 생명 안전, 접근성, 지역 건축법 검토를 대체하지 않습니다.

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

• get_render_job

• list_project_outputs

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

컨테이너 게시

main에 푸시하면 테스트를 실행하고 linux/amd64 이미지를 다음 위치에 게시합니다.

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

라이선스

MIT