Solar Mcp

solar-mcp

用于监测空间天气和 HF 传播状况的 MCP 服务，可通过任何兼容 MCP 的 AI 助手查询实时太阳通量、Kp 指数、DSCOVR 太阳风、X 射线通量、预警、27 天预报，以及逐波段展望。

本项目是 qso-graph 的一部分。无需身份验证——所有数据均来自 NOAA SWPC 公共端点。

安装

uvx solar-mcp            # run it; nothing to install

工具

工具	描述
solar_conditions	当前 SFI、Kp 和 NOAA R/S/G 空间天气等级
solar_forecast	NOAA 提供的 27 天 SFI 和 Kp 预报
solar_alerts	当前生效的空间天气警报和预警
solar_wind	DSCOVR L1 实时太阳风（Bz、速度、密度）
solar_xray	GOES X 射线通量和太阳耀斑分类
solar_band_outlook	HF 各波段传播评估（160m-6m），每个波段均按照 BAND-OUTLOOK.md 中的等级进行评级
get_version_info	服务版本 + 上游规范版本（集群身份认证）

快速开始

无需凭据——只需安装并配置 MCP 客户端。

配置 MCP 客户端

Claude Desktop

将以下内容添加到 claude_desktop_config.json（macOS 上路径为 ~/Library/Application Support/Claude/，Windows 上路径为 %APPDATA%\Claude\）：

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

Claude Code

添加到 .claude/settings.json：

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

ChatGPT Desktop

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

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

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

VS Code / GitHub Copilot

添加到工作区中的 .vscode/mcp.json：

{
  "servers": {
    "solar": {
      "command": "uvx",
      "args": ["solar-mcp"]
    }
  }
}

Gemini CLI

添加到 ~/.gemini/settings.json（全局）或 .gemini/settings.json（项目级）：

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

提问

“当前太阳状况如何？”

“太阳风是否正在引发地磁扰动？”

“未来 27 天的太阳预报是什么样的？”

“现在 HF 上有哪些波段开放？”

“目前有没有生效的空间天气警报？”

“正在发生哪一级太阳耀斑？”

数据来源

所有数值均来自 services.swpc.noaa.gov 上的 NOAA Space Weather Prediction Center 公共端点：

数据	端点	使用工具
10.7 cm 太阳通量（SFI）	/products/summary/10cm-flux.json	solar_conditions、solar_band_outlook
行星 K 指数	/products/noaa-planetary-k-index.json	solar_conditions、solar_band_outlook
NOAA R/S/G 等级	/products/noaa-scales.json	solar_conditions
空间天气警报	/products/alerts.json	solar_alerts
27 天展望	/text/27-day-outlook.txt	solar_forecast
太阳风（实时，每分钟）	/json/rtsw/rtsw_wind_1m.json、/json/rtsw/rtsw_mag_1m.json	solar_wind
GOES X 射线通量	/json/goes/primary/xrays-6-hour.json	solar_xray

离线测试

SOLAR_MCP_MOCK=1 solar-mcp

MCP Inspector

solar-mcp --transport streamable-http --port 8008

开发

git clone https://github.com/qso-graph/solar-mcp.git
cd solar-mcp
uv sync --group dev
uv run pytest

许可证

GPL-3.0-or-later