lattice-mcp-server

このMCPサーバーは、格子QCDから得られる高温・強く相互作用する物質の熱力学という科学ツールを、あらゆるLLMエージェントに公開します。spectra-mcp-serverとgaia-mcp-serverと同じパターンで構築されており、multiagent-client-demo内のマルチエージェントクライアントは、これらのサーバーのどれも変更せずに駆動できます。

科学の背景

核物質を約156 MeV（約2 × 10¹² K）以上に熱すると、ハドロンはクォーク・グルーオンプラズマに溶解します。これは推測ではありません。格子QCDからの第一原理計算の結果であり、RHICやLHCでの重イオン衝突によって地球上でも再現され、宇宙自体もビッグバンから約10 μs後にこの転移を通過して冷却されたのです。ここにあるツールは、クロスオーバーで出合う次の2つの記述を計算します。

• QCD物質の状態方程式 — 連続極限へ外挿した(2+1)-フレーバー格子計算結果の公開パラメトリゼーション（Bazavov et al., HotQCD collaboration, PRD 90, 094503 (2014)）

• ハドロン共鳴気体（HRG）— 約1200個のハドロンと共鳴（QMHRG2020 list）からなる無相互作用気体であり、クォークが解放されると破綻してしまう閉じ込め相の記述

点線のHRG曲線が格子曲線から離れ始める場所こそがデコンファインメントです。

すべての計算は、HotQCD collaboration の公開解析パッケージであるLatticeQCD AnalysisToolbox（pip install latqcdtools）を使って行われています。data/に同梱されているハドロンリストは、そのリポジトリ（MITライセンス）に由来します。

Related MCP server: Mol-MCP

ツール

科学系MCPサーバーで踏襲する価値のある2つの規約があります：

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 という名前のパッケージを提供するため、複数のサーバーを1つの環境に pip install -e しないでください。リポジトリのルートから実行すれば、ローカルパッケージが優先されます。

サーバーの実行

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

クライアントは http://127.0.0.1:8002/mcp に接続します。ポートは、規約として8002です。これにより、このサーバーは spectra (8000)、gaia (8001)、 bb (8003) と並行して実行できます。停止はCtrl+Cです。

このサーバーを Claude Code、Claude デスクトップアプリ、Codex、Cursor、あるいはその他のMCPクライアントから使うには、docs/mcp-clients.mdを参照してください — チェックイン済みの .mcp.json が Claude Code への接続をすでに設定しています。

エージェントに質問してみる

「ハドロン物質はどの温度で溶けますか？格子QCDの状態方程式とハドロン共鳴気体を計算し、それらを重ねて、どこで、なぜズレるのか説明してください。」