NOAA Space Weather MCP Server
アマチュア無線家向けのNOAA宇宙気象データMCPサーバーです。太陽活動データを分析し、HF（短波）のDX伝搬状況を予測するためのツールを提供します。
特徴
🌞 太陽活動データ: 太陽フレア（X線フラックス）、Kp指数、太陽風データをリアルタイムで取得
📡 伝搬分析: 現在の宇宙気象に基づいたHF伝搬状況の分析と推奨バンドの提案
💾 スマートキャッシュ: NOAAサーバーへの負荷を軽減するキャッシュ機構
🔍 クエリ機能: 大きなJSONデータから必要な情報のみを抽出してコンテキストを節約
🐳 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
参考リンク
