NHC MCP Server
MCP server providing AI assistants with access to National Hurricane Center (NHC) storm tracks, advisories, and best track data.
Status: Ready
Tools
| Tool | Description | Status |
|---|---|---|
nhc_get_active_storms |
Get currently active tropical cyclones | Ready |
nhc_get_forecast_track |
Get official NHC 5-day forecast track positions | Ready |
nhc_get_best_track |
Get best track data for historical or recent storms | Ready |
nhc_search_storms |
Search historical storms by name, year, basin, intensity | Ready |
nhc_get_storm_watches_warnings |
Get active watches and warnings for a storm | Ready |
nhc_generate_parametric_wind |
Generate parametric wind field for a storm | Planned |
Data Sources
- CurrentStorms.json — Real-time active storm information from NHC
- ATCF B-deck — Current-season best track data (Automated Tropical Cyclone Forecasting)
- HURDAT2 — Atlantic (1851–2024) and East Pacific (1949–2024) hurricane database
- NHC ArcGIS MapServer — Forecast tracks, cones, and watch/warning polygons
Quick Start
git clone https://github.com/mansurjisan/ocean-mcp.git
cd ocean-mcp/servers/nhc-mcp
uv sync
Configure your MCP client
{
"mcpServers": {
"nhc": {
"command": "uv",
"args": ["run", "--directory", "/path/to/ocean-mcp/servers/nhc-mcp", "python", "-m", "nhc_mcp"]
}
}
}
Example Queries
- "Are there any active tropical cyclones right now?"
- "Show me Hurricane Katrina's track"
- "Search for Category 5 hurricanes in the Atlantic since 2000"
- "What is the forecast track for the active storm AL052024?"
- "Find all storms named Maria"
Running Tests
# Unit tests (fast, no network)
uv run pytest tests/test_utils.py tests/test_client.py -v
# Live integration tests (requires internet)
uv run pytest tests/test_live.py -v -s
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nhc_mcp-0.1.0.tar.gz
(134.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
nhc_mcp-0.1.0-py3-none-any.whl
(17.4 kB
view details)
File details
Details for the file nhc_mcp-0.1.0.tar.gz.
File metadata
- Download URL: nhc_mcp-0.1.0.tar.gz
- Upload date:
- Size: 134.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6919c8dd8b68cd8e931e53156af250dcd4922360e6b3478e1dd17dc5f2e60fc3
|
|
| MD5 |
f807c6a124cab0f4aedab1dc193a724e
|
|
| BLAKE2b-256 |
a17c943c26f2a22f438f42c321166c5620341bcccfadaf9c6af9ff3e4af1e554
|
File details
Details for the file nhc_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: nhc_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 17.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
32243dc702240f3f1f9014812833fb696ee5763b5abb011d55d1985f18582761
|
|
| MD5 |
41c2fff5bdfd899935087c1ba6bf47f5
|
|
| BLAKE2b-256 |
6a75c37f7f7565ae154ed25810ba4bcf2ad4a931a3f023595147f078bfa94b06
|
