English Français العربية

io.github.hoon1983/spaceweather-mcp

السجل الرسمي الخرائط والسفر والطقس

Space weather & geomagnetic conditions (NOAA SWPC, NASA DONKI, USGS, Kyoto) via MCP.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package spaceweather-mcp
Claude Code 
claude mcp add spaceweather-mcp -- uvx spaceweather-mcp==0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "spaceweather-mcp": {
            "command": "uvx",
            "args": [
                "spaceweather-mcp==0.1.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. spaceweather-mcp
  2. Status
  3. Tools
  4. Run
  5. Data sources, attribution & licensing
  6. Safety

spaceweather-mcp

A Model Context Protocol server for space weather and geomagnetic conditions — solar flares, the solar wind, geomagnetic storms (Kp/Dst), radiation storms, sunspot regions, aurora forecasts, and a catalogued event history — so an AI agent can answer "what's the sun/space weather doing right now, and will I see aurora?" from authoritative data.

Sibling to seismic-mcp: that one reconciles earthquakes across agencies; this one reports solar/geomagnetic conditions. They install side by side.

Status

15 tools across 4 data sources — all live and verified. Everything is U.S./NASA public domain except the Kyoto Dst index, which is non-commercial and clearly labeled (and kept segregated from the public-domain feeds).

Tools

NOAA SWPC (public domain)

ToolReturns
get_conditions_nowOne-call snapshot: Kp, Bz/Bt, wind speed/density, G/S/R, storm flag, summary
get_kp_indexObserved planetary Kp series (~1 week)
get_kp_forecastNOAA 3-day Kp forecast
get_solar_windL1 magnetic field + plasma (window: 1-day/7-day)
get_alertsRecent SWPC alerts/watches/warnings
get_noaa_scalesG/S/R scales for today + 3 days
get_27day_outlookDaily F10.7 flux, Ap, largest Kp for 27 days
get_solar_flaresRecent GOES X-ray flares (C/M/X class events)
get_radiation_stormCurrent proton flux + NOAA S-scale (radiation storm)
get_solar_regionsToday's sunspot regions + C/M/X flare probabilities
get_aurora_forecastOVATION aurora probability (pass lat/lon for a local %)

NASA DONKI (public domain) — get_space_weather_events (CME / GST / FLR / SEP / IPS / HSS event catalog)

USGS Geomagnetism (public domain) — list_observatories, get_observatory (magnetometer X/Y/Z/F)

Kyoto WDC (non-commercial) — get_dst (hourly disturbance storm-time index)

Run

uv run spaceweather-mcp        # stdio MCP server
uv run pytest                  # tests

Add to claude_desktop_config.json (after publishing to PyPI):

{ "mcpServers": { "spaceweather": { "command": "uvx", "args": ["spaceweather-mcp"] } } }

Data sources, attribution & licensing

  • NOAA SWPC (services.swpc.noaa.gov) — U.S. public domain. Credit NOAA SWPC.
  • NASA DONKI via CCMC (kauai.ccmc.gsfc.nasa.gov/DONKI) — U.S. public domain (no API key needed). Credit NASA/CCMC DONKI.
  • USGS Geomagnetism (geomag.usgs.gov) — U.S. public domain. Credit the U.S. Geological Survey. (Sourced directly from USGS, not via INTERMAGNET, to keep public-domain status.)
  • Kyoto WDC for Geomagnetism — Dst index, non-commercial use only: acknowledge "WDC for Geomagnetism, Kyoto", cite the Dst DOI; real-time values are provisional. The non-commercial restriction is documented in the get_dst tool description and the DstReading schema (both surfaced to MCP clients), and this feed is kept separate from the public-domain ones.

⚠️ Only the Kyoto Dst feed is non-commercial. It is segregated, and its non-commercial terms are stated in the tool/schema docs the client sees, so a downstream commercial user is not silently bound by those terms.

Deliberately not included: INTERMAGNET and SILSO sunspot number (both CC BY-NC — would taint the otherwise commercially-usable server); JPL Horizons ephemeris (different domain). F10.7 is available via get_27day_outlook; GFZ Hp30/Hp60 high-cadence indices (CC BY 4.0) are a possible future add.

Safety

Informational only. Not for operational decisions affecting power grids, aviation, satellites, or human safety — consult official NOAA SWPC products for those. Real-time values are preliminary and routinely revised.

الأسئلة الشائعة

ما هو io.github.hoon1983/spaceweather-mcp؟

Space weather & geomagnetic conditions (NOAA SWPC, NASA DONKI, USGS, Kyoto) via MCP.

كيف أثبّت io.github.hoon1983/spaceweather-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add spaceweather-mcp -- uvx spaceweather-mcp==0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.hoon1983/spaceweather-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.hoon1983/spaceweather-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.hoon1983/spaceweather-mcp؟

ينشره hoon1983. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.