NOAA Space Weather

You can run and interact with the NOAA Space Weather MCP Server to analyze space weather data and predict HF propagation for amateur radio use. It fetches real-time solar activity, solar wind, and geomagnetic indices, then provides propagation guidance and a smart cache to reduce load on NOAA sources. You can run it locally with STDIO, in a Docker container, or expose it via HTTP for client tools to connect.

How to use

Connect to the server from your MCP client using one of the supported transports. You can run the server locally in STDIO mode or as an HTTP service, then query available tools such as space weather summaries, X-ray flux, Kp index, solar wind, and propagation analysis. Use the HTTP endpoint when you want a stateless, remote-ready connection, or use STDIO for tight integration with local tools.

How to install

Prerequisites: Bun 1.1 or newer and Docker if you plan to use containerized deployments.

Local development setup (STDIO or HTTP mode is available):

Local development commands

Clone the project, install dependencies, and run the development server for STDIO and HTTP modes.

Docker deployment

Build container images for HTTP and STDIO modes, then run the containers.

HTTP transport startup and usage

Start the HTTP server to enable streamable MCP connections, then connect with your MCP client using the HTTP transport.

Available tools

get_space_weather_summary

Fetches the current space weather summary including solar activity indicators and geomagnetic conditions.

get_xray_flux

Retrieves solar flare (X-ray flux) data.

get_kp_index

Provides geomagnetic activity data via the Kp index.

get_solar_wind

Obtains solar wind data for analysis.

analyze_propagation

Analyzes HF propagation conditions and suggests bands.

get_cache_stats

Returns statistics about the internal cache.

clear_cache

Clears the internal cache to force fresh data retrieval.