NOAA TidesAndCurrents MCP

🚀 🌊 NOAA Tides & Currents MCP Server

このプロジェクトは、MCPを通じてNOAAの海洋および大気データへの高速アクセスを提供します。潮汐、潮流、天気、天文学、気候データなど、様々なデータを一元的に取得できます。

🚀 クイックスタート

⚡ NPXによるインストール (推奨)

# インストールと実行を一度に行う - セットアップ不要！
npx @ryancardin/noaa-tides-currents-mcp-server

# または短縮エイリアスを使用
npx noaa-mcp

🔌 トランスポートモード

STDIOモード (デフォルト - MCPプロトコル)

# Claude Desktopとの統合に適した標準的なMCPサーバー
npx @ryancardin/noaa-tides-currents-mcp-server

# または短縮エイリアスを使用
npx noaa-mcp

HTTPストリーム可能モード (Web統合)

# デフォルトポート3000でHTTPサーバーを起動
npx @ryancardin/noaa-tides-currents-mcp-server --http

# カスタムポートを指定
npx @ryancardin/noaa-tides-currents-mcp-server --http --port 8080

# 短縮エイリアスを使用
npx noaa-mcp --http --port 8080

# Server-Sent Events経由でアクセス
curl http://localhost:3000/sse

🎯 Claude Desktopとの統合

Smitheryを介してClaude Desktopに直接インストールします。

npx -y @smithery/cli install @RyanCardin15/tidesandcurrents --client claude

🔧 手動での開発セットアップ

# クローンしてビルド
git clone https://github.com/RyanCardin15/NOAA-Tides-And-Currents-MCP.git
cd NOAA-Tides-And-Currents-MCP
npm install && npm run build

# サーバーを起動
npm start

# FastMCPでテスト
npx fastmcp dev dist/index.js

✨ 主な機能

• 🌊 25以上の専用ツール - 基本的な潮汐データから高度な気候予測まで
• ⚡ 超高速 - FastMCPをベースに構築され、最適なパフォーマンスを実現
• 🎯 ゼロコンフィグ - Claude Desktopでそのまま使用可能
• 🌍 包括的なデータ - 水位、潮流、天気、月相、太陽データなど
• 📊 気候研究に最適 - 海面水位トレンド、洪水予測、極端事象など
• 🚀 NPX対応 - 1つのコマンドでインストールと実行が可能

🛠️ 利用可能なツール

💻 使用例

🌊 現在の潮汐状況を取得

# ボストン港の最新の水位を取得
get_water_levels station="8443970" date="latest"

# マイアミの今日の潮汐予測を取得
get_tide_predictions station="8723214" begin_date="today" end_date="today" interval="hilo"

🌀 ハリケーン対策

# 嵐対策のための極端な水位統計を取得
get_extreme_water_levels station="8518750" units="english"

# 明日の洪水可能性を確認
get_high_tide_flooding_likelihoods station="8518750" date="2024-12-16" threshold="minor"

🔬 気候研究

# 30年間の海面水位トレンドを分析
get_sea_level_trends station="8518750" affiliation="US"

# 中程度の海面水位上昇シナリオでの2050年代の高潮洪水予測を取得
get_high_tide_flooding_projections station="8518750" scenario="intermediate" decade="2050s"

🌙 天文学と航海

# 今夜の月相を航海のために取得
get_moon_phase date="2024-12-15" latitude="42.3601" longitude="-71.0589"

# 航海のための日の出/日の入りを計算
get_sun_times date="2024-12-15" latitude="25.7617" longitude="-80.1918" timezone="America/New_York"

🎣 釣りとレクリエーション

# 現在の予測を利用した最適な釣りの時間を取得
get_current_predictions station="ACT0446" date="today" interval="MAX_SLACK"

# 風と天気の状況を取得
get_meteorological_data station="8443970" product="wind" date="today"

🏗️ 高度な使用法

🔧 開発とテスト

# 開発モードで実行 (stdio)
npm run dev

# HTTPトランスポートでの開発
npm run dev:http

# 異なるトランスポートでの本番ビルド
npm start                    # STDIOモード (デフォルト)
npm run start:http          # ポート3000でのHTTP
npm run start:http:3001     # ポート3001でのHTTP
npm run start:http:8080     # ポート8080でのHTTP

# サーバーの機能を確認
npx fastmcp inspect dist/index.js

🌐 HTTPストリーム統合

HTTPモードで実行すると、サーバーは /sse でServer-Sent Events (SSE) を提供します。

# HTTPサーバーを起動
npx @ryancardin/noaa-tides-currents-mcp-server --http --port 3000

# エンドポイントをテスト
curl -N http://localhost:3000/sse

# またはWebアプリケーションと統合
fetch('http://localhost:3000/sse')
  .then(response => response.body.getReader())
  .then(reader => {
    // ストリーミングMCPレスポンスを処理
  });

HTTPモードの使用例:

• 🌐 Webアプリケーション - React、Vue、Angularアプリとの統合
• 📱 モバイルアプリ - モバイルアプリからのRESTライクなアクセス
• 🔗 APIゲートウェイ - ロードバランサーやAPIゲートウェイを介したプロキシ
• 🧪 テスト - 簡単なcurlベースのテストとデバッグ

📊 データ形式とエクスポート

すべてのツールは複数の出力形式をサポートしています。

• JSON (デフォルト) - プログラムでの使用に最適
• XML - レガシーシステムとの統合
• CSV - 直接スプレッドシートにインポート可能

🌍 グローバルな測定局カバレッジ

• 13,000以上の測定局 世界中
• リアルタイムデータ - NOAAのCO - OPSネットワークから
• 過去の記録 - 数十年にわたるデータ
• グローバルな潮汐予測と潮流予報

🚦 APIエンドポイント

このサーバーは3つのNOAA APIと統合されています。

🔧 技術詳細

アーキテクチャ

• 🚀 FastMCPフレームワーク - 高性能なMCPサーバー
• 📝 TypeScript - 完全な型安全性とIntelliSense
• 🔧 Zodバリデーション - ランタイムでのパラメータバリデーション
• ⚡ Axios HTTPクライアント - 信頼性の高いAPI通信
• 🌙 SunCalc統合 - 正確な天文学計算

トランスポートオプション

• 📡 STDIOトランスポート - デスクトップクライアント向けの標準的なMCPプロトコル
• 🌐 HTTPストリームトランスポート - Web統合に適したServer - Sent Events
• 🔄 デュアルモード対応 - コマンドラインフラグでトランスポートを切り替え可能

システム要件

• Node.js 18以上
• NPM 8以上
• MCPクライアント (Claude Desktopなど)

パッケージサイズ

• 📦 バンドル済み: 43.9 KB
• 📂 インストール後: 286.2 KB
• ⚡ロード時間: 100ms未満

🐛 トラブルシューティング

# Node.jsのバージョンを確認
node --version  # 18以上である必要があります

# TypeScriptを再ビルド
npm run build

📈 ロードマップ

• [ ] 🌊 リアルタイムアラート - 潮汐/天気アラートのWebhookサポート
• [ ] 📱 モバイルSDK - React Nativeとの統合
• [ ] 🗺️ GIS統合 - シェイプファイルとKMLのエクスポート
• [ ] 🤖 AIインサイト - 自動パターン認識
• [ ] ⚡ GraphQL API - 最新のクエリインターフェース
• [ ] 🌐 多言語対応 - I18nサポート

🤝 コントリビューション

コントリビューションを大歓迎します！始めるには以下の手順に従ってください。

1. 🍴 リポジトリをフォークします
2. 🌿 新しいブランチを作成します (git checkout -b amazing-feature)
3. 💻 改良点をコーディングします
4. ✅ npm test でテストします
5. 📤 プルリクエストを送信します

開発コマンド

npm run build    # TypeScriptをビルド
npm run dev      # 開発モード
npm run test     # テストスイートを実行
npm run format   # Prettierでフォーマット

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

Ryan Cardinによって愛情を込めて作成されました。

🔗 リンクとリソース

• 📦 NPMパッケージ: @ryancardin/noaa-tides-currents-mcp-server
• 🏪 Smithery: Claude Desktop用の自動インストール
• 🌊 NOAA CO - OPS: 公式NOAAデータポータル
• 🤖 MCPプロトコル: Model Context Protocolドキュメント
• ⚡ FastMCP: FastMCPフレームワーク