OceanMCP

A monorepo of independently installable MCP servers for ocean and coastal data workflows.

Servers

| Server | PyPI | Description | |--------|------|-------------| | coops-mcp | | NOAA CO-OPS tides, water levels, currents, meteorological data | | erddap-mcp | | Universal ERDDAP data access across 80+ public servers | | nhc-mcp | | NHC storm tracks, advisories, HURDAT2 best track data | | recon-mcp | | Hurricane reconnaissance data (HDOB, Vortex Data Messages, ATCF fixes) | | stofs-mcp | | NOAA STOFS storm surge forecasts and observation validation | | ofs-mcp | | NOAA OFS regional ocean model forecasts (water level, temperature, salinity) | | rtofs-mcp | | NOAA RTOFS global ocean forecasts (SST, salinity, currents, SSH) via HYCOM THREDDS | | ww3-mcp | | GFS-Wave (WAVEWATCH III) forecasts and NDBC buoy wave observations |

No API keys required — all servers use free, publicly available datasets.

Quick Start

Install from PyPI

# uvx (recommended) — runs without permanent install, like npx for Python
uvx coops-mcp

# pip — install into current environment
pip install coops-mcp

# pipx — install in isolated environment with CLI entry point
pipx install coops-mcp

Replace coops-mcp with any server: erddap-mcp, nhc-mcp, recon-mcp, stofs-mcp, ofs-mcp, rtofs-mcp, ww3-mcp.

Install from source

git clone https://github.com/mansurjisan/ocean-mcp.git
cd ocean-mcp/servers/coops-mcp  # or erddap-mcp, nhc-mcp, recon-mcp, stofs-mcp, ofs-mcp, rtofs-mcp, ww3-mcp
uv sync

Configure your MCP client

Add to your MCP settings (e.g., project .mcp.json):

Using PyPI packages (recommended):

{
  "mcpServers": {
    "coops": {
      "command": "uvx",
      "args": ["coops-mcp"]
    },
    "erddap": {
      "command": "uvx",
      "args": ["erddap-mcp"]
    },
    "nhc": {
      "command": "uvx",
      "args": ["nhc-mcp"]
    },
    "recon": {
      "command": "uvx",
      "args": ["recon-mcp"]
    },
    "stofs": {
      "command": "uvx",
      "args": ["stofs-mcp"]
    },
    "ofs": {
      "command": "uvx",
      "args": ["ofs-mcp"]
    },
    "rtofs": {
      "command": "uvx",
      "args": ["rtofs-mcp"]
    },
    "ww3": {
      "command": "uvx",
      "args": ["ww3-mcp"]
    }
  }
}

{
  "mcpServers": {
    "coops": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/coops-mcp", "python", "-m", "coops_mcp"]
    },
    "erddap": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/erddap-mcp", "python", "-m", "erddap_mcp"]
    },
    "nhc": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/nhc-mcp", "python", "-m", "nhc_mcp"]
    },
 

... [View full README on GitHub](https://github.com/mansurjisan/ocean-mcp#readme)