spaceweather-mcp

spaceweather-mcp

一个用于空间天气和地磁状况的 Model Context Protocol 服务，涵盖太阳耀斑、太阳风、地磁暴（Kp/Dst）、辐射暴、太阳黑子区、极光预报和编目事件历史，让 AI Agent 能够根据权威数据回答“太阳／空间天气现在是什么情况？我能看到极光吗？”。

与 seismic-mcp 同属一类：前者综合各机构的地震数据；本项目则报告太阳和地磁状况。两者可以并行安装。

状态

4 个数据源提供 15 个工具，均已上线并经过验证。 除京都 Dst 指数为非商业用途（并已明确标注，且与公有领域数据源隔离）外，所有数据均属于美国／NASA 公有领域。

工具

NOAA SWPC（公有领域）

工具	返回内容
get_conditions_now	一次调用获取概览：Kp、Bz/Bt、风速／密度、G/S/R、风暴标记、摘要
get_kp_index	行星 Kp 观测序列（约 1 周）
get_kp_forecast	NOAA 3 天 Kp 预报
get_solar_wind	L1 磁场 + 等离子体（window：1-day/7-day）
get_alerts	SWPC 最新警报／监视／预警
get_noaa_scales	今天及未来 3 天的 G/S/R 级别
get_27day_outlook	27 天的每日 F10.7 通量、Ap 和最大 Kp
get_solar_flares	近期 GOES X 射线耀斑（C/M/X 级事件）
get_radiation_storm	当前质子通量 + NOAA S 级别（辐射暴）
get_solar_regions	今日太阳黑子区 + C/M/X 级耀斑概率
get_aurora_forecast	OVATION 极光概率（传入纬度／经度以获取当地概率）

NASA DONKI（公有领域）— get_space_weather_events（CME / GST / FLR / SEP / IPS / HSS 事件目录）

USGS Geomagnetism（公有领域）— list_observatories、get_observatory（磁力计 X/Y/Z/F）

Kyoto WDC（非商业用途）— get_dst（每小时扰动风暴时间指数）

运行

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

发布到 PyPI 后，将其添加到 claude_desktop_config.json：

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

数据源、署名与许可

• NOAA SWPC（services.swpc.noaa.gov）— 美国公有领域。请注明 NOAA SWPC。
• NASA DONKI，通过 CCMC 提供（kauai.ccmc.gsfc.nasa.gov/DONKI）— 美国公有领域（无需 API 密钥）。请注明 NASA/CCMC DONKI。
• USGS Geomagnetism（geomag.usgs.gov）— 美国公有领域。请注明美国地质调查局。（数据直接来自 USGS，而非通过 INTERMAGNET，以保持公有领域状态。）
• 京都地磁 WDC — Dst 指数，仅限非商业用途：请注明“WDC for Geomagnetism, Kyoto”，引用 Dst DOI；实时值为暂定值。get_dst 工具说明和 DstReading 架构中均注明了非商业用途限制（这两项都会展示给 MCP 客户端），并且该数据源与公有领域数据源分开。

⚠️ 只有京都 Dst 数据源仅限非商业用途。该数据源已隔离，并且客户端可见的工具／架构文档中注明了其非商业条款，因此下游商业用户不会在不知情的情况下受这些条款约束。

有意不纳入： INTERMAGNET 和 SILSO 太阳黑子数（两者均采用 CC BY-NC 许可，会使原本可用于商业用途的服务受到限制）；JPL Horizons 星历（属于不同领域）。F10.7 可通过 get_27day_outlook 获取；GFZ Hp30/Hp60 高频指数（CC BY 4.0）可能会在未来加入。

安全

仅供参考。不得用于影响电网、航空、卫星或人身安全的运行决策；此类情况请查阅 NOAA SWPC 官方产品。实时值为初步数据，通常会进行修订。