lattice-mcp-server

격자 QCD(lattice QCD)로부터 얻은 뜨겁고 강하게 상호작용하는 물질의 열역학이라는 과학 도구를 모든 LLM 에이전트에 노출하는 MCP 서버입니다. spectra-mcp-server 및 gaia-mcp-server와 같은 패턴으로 구축되었으며, multiagent-client-demo의 멀티에이전트 클라이언트는 이 서버들을 수정 없이 구동합니다.

과학

핵 물질을 약 156 MeV(~2 × 10¹² K) 이상으로 가열하면 하드론이 쿼크-글루온 플라스마로 용해됩니다. 이것은 추측이 아닙니다. 격자 QCD의 제1원리(first-principles) 결과이며, RHIC과 LHC의 중이온 충돌을 통해 지구에서 재현되고, 우주 자체도 빅뱅 후 약 10 μs에 이 전이를 지나며 냉각되었습니다. 여기서 제공하는 도구들은 크로스오버(crossover)에서 만나는 두 가지 기술을 계산합니다:

• QCD 물질의 상태 방정식 — 연속체 극한(continuum-extrapolated) (2+1)-플레이버 격자 결과의 발표된 파라미터화(Bazavov et al., HotQCD collaboration, PRD 90, 094503 (2014)),

• 하드론 공명 기체(HRG) — 약 1200개의 하드론과 공명 상태로 이루어진 비상호작용 기체(QMHRG2020 목록)로, 쿼크가 자유로워지면 반드시 실패하게 되는 구속상(confined-phase) 기술입니다.

점선 HRG 곡선이 격자 곡선에서 떨어져 나가는 곳이 바로 탈구속(deconfinement)입니다:

모든 것은 LatticeQCD AnalysisToolbox(pip install latqcdtools), 즉 HotQCD collaboration의 공개 분석 패키지로 계산됩니다. data/에 번들된 하드론 목록은 해당 저장소(MIT 라이선스)에서 가져온 것입니다.

Related MCP server: Mol-MCP

도구

과학 MCP 서버에 적용할 만한 두 가지 관례:

1. 모든 도구는 {status, files, message, metadata}(ArtifactResult)를 반환합니다.

2. 배열은 도구 간에 파일 경로로 전달되며, 에이전트의 컨텍스트 창을 통해서는 절대 전달되지 않습니다.

설치

conda create -n lattice-tutorial python=3.12 -y
conda activate lattice-tutorial
pip install -e ".[dev]"
pytest

다른 서버에서 이미 spectra-tutorial 환경을 갖고 있나요? 그대로 재사용할 수 있습니다: pip install latqcdtools를 실행한 다음, 이 서버(및 pytest)를 항상 이 저장소의 루트 디렉터리에서 실행하세요. 모든 튜토리얼 서버는 tools와 mcp_server라는 이름의 패키지를 내보내므로, 여러 서버를 한 환경에 pip install -e 하지 마세요. 저장소 루트에서 실행하면 로컬 패키지가 우선합니다.

서버 실행

python -m mcp_server --transport streamable-http --port 8002

클라이언트는 http://127.0.0.1:8002/mcp에 연결합니다. 관례상 포트 8002를 사용하므로 이 서버는 spectra(8000), gaia(8001), bbn(8003)과 함께 실행될 수 있습니다. Ctrl+C로 중지합니다.

Claude Code, Claude 데스크톱 앱, Codex, Cursor 또는 다른 MCP 클라이언트에서 이 서버를 사용하려면 docs/mcp-clients.md를 참조하세요. 커밋된 .mcp.json이 이미 이 서버를 Claude Code에 연결해 둡니다.

에이전트에게 물어볼 질문

"하드론 물질은 어느 온도에서 녹을까? 격자 QCD 상태 방정식과 하드론 공명 기체를 계산하고, 둘을 겹쳐서 어디에서, 왜 불일치하는지 설명하라."