Metadata-Version: 2.4
Name: ndbc-mcp
Version: 0.1.0
Summary: MCP server providing access to NOAA NDBC buoy observations: waves, SST, wind, pressure from 1,300+ stations
Project-URL: Homepage, https://github.com/mansurjisan/ocean-mcp
Project-URL: Repository, https://github.com/mansurjisan/ocean-mcp
Project-URL: Bug Tracker, https://github.com/mansurjisan/ocean-mcp/issues
Project-URL: Documentation, https://github.com/mansurjisan/ocean-mcp/tree/main/servers/ndbc-mcp
Project-URL: Changelog, https://github.com/mansurjisan/ocean-mcp/releases
Author-email: Mansur Ali Jisan <mansur.jisan@noaa.gov>
License-Expression: MIT
License-File: LICENSE
Keywords: buoy,mcp,meteorology,model-context-protocol,ndbc,noaa,ocean-observations,oceanography,sea-surface-temperature,waves
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# ndbc-mcp

MCP server providing access to NOAA National Data Buoy Center (NDBC) observations from 1,300+ offshore stations.

## Features

- Real-time buoy observations: wind, waves, SST, pressure, air temperature
- Spectral wave data with swell/wind-wave separation
- Station discovery by location, type, or owner
- Daily statistical summaries (min/max/mean)
- Multi-station comparison

## Data Sources

- **NDBC Realtime2**: `https://www.ndbc.noaa.gov/data/realtime2/` -- 45-day rolling archive, updated every ~10 min
- **Active Stations XML**: `https://www.ndbc.noaa.gov/activestations.xml` -- 1,350 stations with metadata

No API keys required.

## Installation

```bash
# Using uvx (recommended)
uvx ndbc-mcp

# Using pip
pip install ndbc-mcp
```

## Tools

| Tool | Description |
|------|-------------|
| `ndbc_list_stations` | List active stations with filters (type, owner, met sensors) |
| `ndbc_get_station` | Get metadata for a specific station |
| `ndbc_find_nearest_stations` | Find stations near a lat/lon coordinate |
| `ndbc_get_latest_observation` | Latest observation (all variables) |
| `ndbc_get_observations` | Time series from realtime2 (configurable hours) |
| `ndbc_get_wave_summary` | Spectral wave summary (swell/wind-wave separation) |
| `ndbc_get_daily_summary` | Daily min/max/mean for key variables |
| `ndbc_compare_stations` | Side-by-side comparison of 2-10 stations |

## Configuration

### Claude Desktop

```json
{
  "mcpServers": {
    "ndbc": {
      "command": "uvx",
      "args": ["ndbc-mcp"]
    }
  }
}
```

## License

MIT
