PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

0.1.2

PyPI

adcirc-mcp

MCP server for ADCIRC model setup debugging, parameter lookup, and configuration validation

Published1 Oct 2026
Direct dependencies3
Transitive dependenciesNot calculated

README

Version 0.1.2 documentation

adcirc-mcp

MCP server for ADCIRC model setup debugging, parameter lookup, and configuration validation.

Unlike the other ocean-mcp servers that query remote NOAA APIs, adcirc-mcp parses local model input files and provides embedded domain knowledge to help debug and understand ADCIRC configurations.

Tools (10)

Parameter Reference

  • adcirc_explain_parameter — Look up any fort.15 parameter, NWS value, tidal constituent, or nodal attribute
  • adcirc_list_parameters — List all parameters grouped by category

File Parsing

  • adcirc_parse_fort15 — Parse fort.15 control file into structured summary
  • adcirc_parse_fort14 — Parse fort.14 mesh file header (node/element counts, boundaries)
  • adcirc_parse_fort13 — Parse fort.13 nodal attributes (names, defaults, non-default counts)
  • adcirc_parse_fort22 — Parse fort.22 meteorological forcing header

Validation & Debugging

  • adcirc_validate_config — Comprehensive validation with CFL check and cross-file verification
  • adcirc_diagnose_error — Match error text against known ADCIRC failure patterns

Documentation

  • adcirc_fetch_docs — Fetch pages from the ADCIRC wiki
  • adcirc_search_docs — Search the ADCIRC wiki

Installation

# Using uvx (recommended)
uvx adcirc-mcp

# Or install from source
cd servers/adcirc-mcp
uv sync

Configuration

Add to your MCP client config:

{
  "mcpServers": {
    "adcirc": {
      "command": "uvx",
      "args": ["adcirc-mcp"]
    }
  }
}

Development

cd servers/adcirc-mcp
uv sync --group dev
uv run pytest tests/ --ignore=tests/test_live.py --ignore=tests/test_mcp_protocol.py -v

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 3

Native requirements
3 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
httpx
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
httpx<1,>=0.27.0runtime
mcp
Environment
{
  "extras": "cli",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
mcp[cli]<2,>=1.0.0runtime
pydantic
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
pydantic<3,>=2.0.0runtime

Distribution files

2 collected
adcirc_mcp-0.1.2-py3-none-any.whl

bdist_wheel · 26.19 KB · Python py3

Source file
adcirc_mcp-0.1.2.tar.gz

sdist · 28.78 KB · Python source

Source file

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 19:14 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:4b0872b4a5e718e52c462cdbd4dbaa0c07b7b7f41b8770747463c8066fcbc602

Other collected versions

View all collected versions →