hydroemu-mcp-server

HACC宇宙論的流体シミュレーションエミュレータ（事前学習済みSEPIAガウス過程モデル）を、任意のLLMエージェント向けツールとして公開するMCPサーバーです。

このリポジトリが教える一つのアイデア

科学コードは通常のPythonのまま。MCPラッパーはそれを公開するだけ。

• tools/ は通常の科学パッケージです。MCPを一切インポートしません。エミュレータツールは tools/hydro_tools.py に、SEPIAラッパーの中核は tools/emulator.py にあります。

• mcp_server/ は約70行の汎用ラッパーです。pyproject.toml から1行の設定を読み、科学パッケージをインポートし、その __all__ にリストされたすべての関数をMCPツールとして登録します。

[tool.mcp-server]
tool_modules = ["tools"]

あなたの型ヒント、Pydanticの Field 制約、docstringが、エージェントが見るツールスキーマになります。独自サーバーを構築するには：モジュールを tools/ に置く（またはその1行の設定を自分のパッケージに向ける）だけで、__all__ に公開関数をリストすれば完了です。

Related MCP server: MCP Refana Server

レイアウト

models/                           Pre-trained SEPIA pickles (copy from CosmoHydro/models/)
tools/
  emulator.py                    Core SEPIA wrapper: lazy load, predict, redshift interpolation
  hydro_tools.py                 The 5 MCP tool functions + ArtifactResult contract
  __init__.py                    __all__ — ONLY these names become tools
mcp_server/                      Generic drop-in wrapper (FastMCP)
tests/test_tools.py              Tools tested as plain Python, no MCP needed
docs/mcp-clients.md              Multi-client setup guide

パラメータ

合計7パラメータ（サブグリッド5 + 宇宙論2）：

設計：ラテン超方格設計による110シミュレーション（400 Mpc/hボックス）。

観測量

ツール

科学MCPサーバーにコピーする価値のある2つの慣習：

1. すべてのツールは {status, files, message, metadata}（ArtifactResult）を返す。

2. 配列はツール間でファイルパスとして移動し、エージェントのコンテキストウィンドウを経由しない。

インストール

conda create -n hydroemu python=3.12 -y
conda activate hydroemu
pip install -e ".[dev]"
pytest                        # tests pass without SEPIA models (fixture data)

事前学習済みモデル

CosmoHydro/models/ から学習済みSEPIA pickleを models/ ディレクトリにコピーします：

cp -r /path/to/CosmoHydro/models/GSMF_multiz models/
cp -r /path/to/CosmoHydro/models/HMF_multiz models/
# ... etc for each observable

モデルがなくても、list_observables()、describe_parameters()、plot_observable_comparison() は動作します。pickleを必要とするのは predict_observable と predict_observable_redshift のみです。

サーバーの起動

Streamable HTTP — サーバーはURLを持つ可視プロセスです：

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

クライアントは http://127.0.0.1:8000/mcp に接続します。サーバーを停止するには Ctrl+C を押します（Ctrl+Zは一時停止するだけで、ポートが占有されたままになります。その場合はサーバーを再起動するだけです：ポートを保持している残存 mcp_server を検出し、自動的にクリアします）。

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

アーキテクチャ

このサーバーは spectra-mcp-server と同じアーキテクチャに従います：

エミュレータプロット

CosmoHydroトレーニングノートブックからの24の検証、感度、比較プロットについては、完全なギャラリー を参照してください。ハイライト：

アーキテクチャ（詳細）

• mcp_server/ は汎用ドロップインMCPラッパー（リポジトリ間でコピー）

• tools/ にはドメイン固有の科学関数が含まれる

• pyproject.toml の [tool.mcp-server] 設定がそれらを結びつける

• すべてのSEPIAインポートは遅延（モジュールスコープではなく関数内）

• モデルは初回使用時にロードされ、以降の呼び出しでキャッシュされる