Metadata-Version: 2.4
Name: recon-mcp
Version: 0.1.1
Summary: MCP server for NOAA hurricane reconnaissance data (HDOB, VDM, ATCF fixes)
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/recon-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: hdob,hurricane,mcp,meteorology,model-context-protocol,noaa,reconnaissance,tropical-cyclone,vortex-data-message
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: netcdf4>=1.7.0
Requires-Dist: numpy>=1.26.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# recon-mcp

MCP server for NOAA hurricane reconnaissance data — HDOB flight observations, Vortex Data Messages, and ATCF aircraft fixes.

## Tools

| Tool | Description |
|------|-------------|
| `recon_list_missions` | List available reconnaissance data files from the NHC archive |
| `recon_get_hdobs` | Get HDOB 30-second flight-level observations (winds, pressure, SFMR) |
| `recon_get_vdms` | Get Vortex Data Messages (storm center fixes with intensity) |
| `recon_get_fixes` | Get ATCF f-deck aircraft fix records |

## Installation

```bash
# With uv
uv pip install .

# Or with pip
pip install .
```

## Usage

```bash
# Run the MCP server
recon-mcp

# Or via Python
python -m recon_mcp
```

## Data Sources

- **NHC Reconnaissance Archive**: `https://www.nhc.noaa.gov/archive/recon/`
- **ATCF Fix Data**: `https://ftp.nhc.noaa.gov/atcf/fix/`

<!-- mcp-name: io.github.mansurjisan/recon-mcp -->
