NOAA Space Weather MCP Server

アマチュア無線家向けの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 Prediction Center
• Model Context Protocol
• Bun