regional-ocean-debugger-mcp

MCP server for debugging regional ocean (MOM6 + CESM) model runs.

Combines practical log analysis tools with a searchable knowledge base of expert interview transcripts, giving an LLM agent both the ability to inspect model output files and access to domain-expert guidance.

Tools

Resources

{case_dir*} takes the case path as-is, slashes included, e.g. ocean://case//glade/u/home/<user>/croc_cases/my_case/errors.

Knowledge Base

Domain knowledge comes from expert interviews on regional MOM6 modelling (private repo: AidanJanney/RegionalOceanModelingInterviews). Topics include: OBC setup, tidal forcing, bathymetry, stability, BGC, grid design, and regional ocean dynamics.

The transcripts are a git submodule in data/transcripts/. After cloning this repo:

git submodule update --init data/transcripts

Setup

pip install -e .
# with the transcripts submodule:
git submodule update --init data/transcripts

Running

regional-ocean-debugger-mcp
# or
python server.py

Add to .mcp.json:

{
  "mcpServers": {
    "ocean-debugger": {
      "command": "python",
      "args": ["/path/to/MCP_regional_ocean_debugger/server.py"]
    }
  }
}

Design

• Stateless: reads from the filesystem per call
• No ML dependencies: knowledge search is keyword-based (fast, transparent, works without GPU)
• Composable: use find_errors → classify_error → query_domain_knowledge in sequence for triage
• Private data: transcripts submodule is private; do not make public without authorisation

CESM / MOM6 paths on Derecho

Cases: ~/croc_cases/ Run dir: the case's RUNDIR (default $CIME_OUTPUT_ROOT/$CASE/run, read from env_run.xml) MOM_input: RUNDIR/MOM_input or <case_dir>/Buildconf/momconf/MOM_input diag_table: RUNDIR/diag_table or <case_dir>/Buildconf/momconf/diag_table