LaminateAnalyzerMCP

적층 복합재의 중립면(neutral surface)·ABD 강성·평가 지표를 결정론적으로 계산하는 MCP 서버. LLM 에이전트가 계산을 직접 하지 않고 이 서버를 호출한다. 동일 입력 → 바이트 동일 응답(payload_hash 추적).

• 계획/사양: docs/mcp_laminate_planning.md (수학 사양·규약·오류코드의 단일 소스)
• 진행 상태: checklist.md · 결정 기록: context-notes.md

Tool 11종 (MVP 7 + V1 4)

analyze_laminate(원샷 진입점) · validate_laminate_input · compute_abd_matrix · compute_neutral_axis · evaluate_laminate · get_reference_cases(폐형해 자가검증) · get_server_info · solve_load_response(ε0/κ·유효 공학 상수) · run_sensitivity_analysis · batch_evaluate_laminates(≤32) · generate_design_report(ko/en)

핵심 규약. laminae[0] = 최하단 ply, 각도 deg(CCW), unit_system 필수(SI | SI_mm), 하중은 단위 폭당. 에이전트용 상세 절차는 docs/agent_guide.md, 수식 유도는 docs/math_spec.md, 두 MCP 협동 실 세션 기록은 docs/s5_scenario_log.md.

실행

# 로컬 stdio (Claude Code는 .mcp.json으로 자동 연결 — materialtwin과 함께 등록됨)
.venv/bin/laminate-mcp

# HTTP (HEAXHub fastapi 스택과 동일 형태)
.venv/bin/python -m uvicorn app.main:app --host 127.0.0.1 --port 8000 --root-path /apps/laminate_analyzer_mcp
# → GET /health, MCP는 POST /mcp (streamable HTTP)

hwax portal(HEAXHub) 등록 — 완료

HEAXHub/integrations/laminate-analyzer-mcp가 이 리포지토리의 심볼릭 링크(in-tree 통합)이고, .portal/manifest.yaml(schema v2)이 정본이다. 카탈로그 등록·빌드·서비스 기동·Caddy 라우트까지 실증 완료(2026-07-16). Caddy 라우트는 forward_auth(/api/v1/authz) → prefix strip → 127.0.0.1:<port> 구조라 포털 경유 접속에는 포털 인증이 필요하다(visibility: team).

# 에이전트 연결 (포털 경유 — 인증 토큰 필요)
claude mcp add --transport http laminate-analyzer \
  <포털베이스>/apps/laminate_analyzer_mcp/mcp --header "Authorization: Bearer <token>"

개발

python3.12 -m venv .venv && .venv/bin/pip install -e ".[test]"
.venv/bin/pytest            # 75 tests