How do I use NOAA Space Weather MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@NOAA Space Weather MCP Server what's the current HF propagation conditions for 20m band?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

NOAA Space Weather MCP Server

License: MIT

アマチュア無線家向けのNOAA宇宙気象データMCPサーバーです。太陽活動データを分析し、HF（短波）のDX伝搬状況を予測するためのツールを提供します。

特徴

🌞 太陽活動データ: 太陽フレア（X線フラックス）、Kp指数、太陽風データをリアルタイムで取得
📡 伝搬分析: 現在の宇宙気象に基づいたHF伝搬状況の分析と推奨バンドの提案
💾 スマートキャッシュ: NOAAサーバーへの負荷を軽減するキャッシュ機構
🔍 クエリ機能: 大きなJSONデータから必要な情報のみを抽出してコンテキストを節約
🐳 Docker対応: コンテナでの簡単なデプロイ

インストール

前提条件

Bun 1.1以上
Docker（コンテナ利用時）

ローカル開発

# リポジトリをクローン
git clone https://github.com/numa08/noaa-space-weather-mcp.git
cd noaa-space-weather-mcp

# 依存関係のインストール
bun install

# 開発サーバー起動（STDIO）
bun run dev

# HTTP サーバーとして起動
bun run dev:http

Docker

# HTTPモード用イメージのビルド（Bun）
docker build -t numa08/noaa-space-weather-mcp:http .

# STDIOモード用イメージのビルド（Node.js）
docker build -f Dockerfile.stdio -t numa08/noaa-space-weather-mcp:stdio .

# コンテナの起動（HTTPモード）
docker run -p 3000:3000 numa08/noaa-space-weather-mcp:http

# コンテナの起動（STDIOモード）
docker run -i numa08/noaa-space-weather-mcp:stdio

Docker Hubからの利用

# HTTPモード
docker pull numa08/noaa-space-weather-mcp:http
docker run -p 3000:3000 numa08/noaa-space-weather-mcp:http

# STDIOモード
docker pull numa08/noaa-space-weather-mcp:stdio
docker run -i numa08/noaa-space-weather-mcp:stdio

Note: STDIOモードではNode.jsランタイムを使用しています。これはBunのstdoutバッファリング問題（oven-sh/bun#15893）を回避するためです。HTTPモードではBunを使用し、高速な起動とレスポンスを実現しています。

MCPサーバーのセットアップ

方法1: STDIOトランスポート（ローカル実行）

ローカル環境でClaude DesktopやClaude Codeと連携する場合に推奨される方法です。

Claude Desktop

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "noaa-space-weather": {
      "command": "bun",
      "args": ["run", "/path/to/noaa-space-weather-mcp/src/index.ts"]
    }
  }
}

Claude Code

# ローカルソースから（Bun使用）
claude mcp add noaa-space-weather -- bun run /path/to/noaa-space-weather-mcp/src/index.ts

# 設定の確認
claude mcp list

方法2: STDIOトランスポート（Docker）

Dockerコンテナを使用してSTDIOモードで接続する方法です。

Claude Desktop

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "noaa-space-weather": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "numa08/noaa-space-weather-mcp:stdio"]
    }
  }
}

Claude Code

# Docker Hub から（Node.js STDIOイメージ）
claude mcp add noaa-space-weather -- docker run -i --rm numa08/noaa-space-weather-mcp:stdio

# 設定の確認
claude mcp list

方法3: HTTPトランスポート（リモート/Docker）

サーバーレス環境やDockerコンテナでの運用に推奨される方法です。 Streamable HTTPトランスポート（ステートレスモード）を使用します。

サーバーの起動

# ローカルで起動
bun run start:http --port 3000

# Dockerで起動
docker run -p 3000:3000 numa08/noaa-space-weather-mcp:http

エンドポイント

エンドポイント	メソッド	説明
`/mcp`	POST/GET/DELETE	MCP Streamable HTTPエンドポイント
`/health`	GET	ヘルスチェック
`/stats`	GET	キャッシュ統計

Claude Code（HTTP接続）

# HTTPトランスポートで接続
claude mcp add noaa-space-weather --transport http http://localhost:3000/mcp

# 設定の確認
claude mcp list

動作確認

# ヘルスチェック
curl http://localhost:3000/health

# MCP初期化リクエスト（Streamable HTTP）
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}'

# ツール一覧の取得
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}'

利用可能なツール

ツール名	説明
`get_space_weather_summary`	現在の宇宙気象サマリーを取得
`get_xray_flux`	太陽フレア（X線フラックス）データを取得
`get_kp_index`	地磁気活動（Kp指数）データを取得
`get_solar_wind`	太陽風データを取得
`analyze_propagation`	HF伝搬状況を分析
`get_cache_stats`	キャッシュ統計を表示
`clear_cache`	キャッシュをクリア

クエリの例

# 過去24時間のKp指数を取得（最新10件）
get_kp_index: { "hours": 24, "limit": 10 }

# 特定期間のX線フラックスを取得
get_xray_flux: { "query": "startTime=2024-01-01&endTime=2024-01-07&limit=20" }

# 20mバンドの伝搬分析
analyze_propagation: { "targetBand": "20m" }

アマチュア無線と宇宙気象

Kp指数の解釈

Kp値	状態	HF伝搬への影響
0-2	静穏	良好な伝搬条件
3-4	不安定	軽微な乱れの可能性
5+	磁気嵐	高緯度で伝搬悪化

太陽フレアの分類

クラス	強度	短波通信への影響
A, B	背景レベル	影響なし
C	小規模	軽微な影響
M	中規模	昼側でフェードアウト
X	大規模	大規模ブラックアウト

開発

# テストの実行
bun run test

# 静的解析
bun run lint

# 型チェック
bun run typecheck

# すべてのチェックを実行
bun run check

ライセンス

MIT License

NOAA Space Weather MCP Server

NOAA Space Weather MCP Server

特徴

インストール

前提条件

ローカル開発

Docker

Docker Hubからの利用

MCPサーバーのセットアップ

方法1: STDIOトランスポート（ローカル実行）

Claude Desktop

Claude Code

方法2: STDIOトランスポート（Docker）

Claude Desktop

Claude Code

方法3: HTTPトランスポート（リモート/Docker）

サーバーの起動

エンドポイント

Claude Code（HTTP接続）

動作確認

利用可能なツール

クエリの例

アマチュア無線と宇宙気象

Kp指数の解釈

太陽フレアの分類

開発

ライセンス

参考リンク

Resources

Latest Blog Posts

MCP directory API