noaa-tidesandcurrents-mcp

NOAA 潮汐と海流 MCP サーバー

これは、FastMCP フレームワークを使用して NOAA Tides and Currents API と対話するためのツールを提供する MCP (Model Context Protocol) サーバーです。

特徴

• 水位データの取得（リアルタイムおよび履歴）
• 潮汐予測（高潮/低潮または間隔ベース）
• 電流データ（リアルタイムおよび履歴）
• 現在の予測
• ステーションメタデータの取得
• 風、気温、水温、その他の気象データ
• 月の満ち欠け情報（過去、現在、未来）
• 日の出/日の入りと位置データ（過去、現在、未来）

前提条件

• Node.js (v18以上)
• npmまたはyarn

設定

Smithery経由でインストール

Smithery経由で Claude Desktop に NOAA Tides and Currents を自動的にインストールするには:

手動インストール

1. このリポジトリをクローンする
2. 依存関係をインストールする

3. .env.exampleファイルに基づいて.envファイルを作成します。

4. TypeScriptコードをビルドする

5. サーバーを起動する

使用法

この MCP サーバーは、Claude Desktop などの任意の MCP ホストで使用でき、MCP プロトコルを通じて NOAA Tides and Currents API を使用できます。

fastmcpコマンドライン ツールを使用して直接テストすることもできます。

または、MCP Inspector を使用することもできます。

利用可能なツール

水位

• get_water_levels - ステーションの水位データを取得する
  • パラメータ:
    • station (文字列) - ステーションID
    • date （文字列、オプション） - データを取得する日付（「今日」、「最新」、「最近」、または特定の日付）
    • begin_date (文字列、オプション) - 開始日 (YYYYMMDD または MM/DD/YYYY)
    • end_date (文字列、オプション) - 終了日 (YYYYMMDD または MM/DD/YYYY)
    • range （数値、オプション） - データを取得する時間数
    • datum (文字列、オプション) - 使用するデータム (MLLW、MSL など)
    • units （文字列、オプション） - 使用する単位（「英語」または「メートル法」）
    • time_zone (文字列、オプション) - タイムゾーン (gmt、lst、lst_ldt)
    • format (文字列、オプション) - 出力形式 (json、xml、csv)

潮汐予測

• get_tide_predictions - 潮汐予測データを取得する
  • パラメータ:
    • station (文字列) - ステーションID
    • begin_date (文字列) - 開始日 (YYYYMMDD または MM/DD/YYYY)
    • end_date (文字列) - 終了日 (YYYYMMDD または MM/DD/YYYY)
    • datum (文字列、オプション) - 使用するデータム (MLLW、MSL など)
    • units （文字列、オプション） - 使用する単位（「英語」または「メートル法」）
    • time_zone (文字列、オプション) - タイムゾーン (gmt、lst、lst_ldt)
    • interval (文字列、オプション) - 間隔 (hilo、hl、h、または分単位の数値)
    • format (文字列、オプション) - 出力形式 (json、xml、csv)

流れ

• get_currents - ステーションの電流データを取得する
  • パラメータ:
    • station (文字列) - ステーションID
    • date （文字列、オプション） - データを取得する日付（「今日」、「最新」、「最近」、または特定の日付）
    • begin_date (文字列、オプション) - 開始日 (YYYYMMDD または MM/DD/YYYY)
    • end_date (文字列、オプション) - 終了日 (YYYYMMDD または MM/DD/YYYY)
    • bin (数値、オプション) - ビン番号
    • units （文字列、オプション） - 使用する単位（「英語」または「メートル法」）
    • time_zone (文字列、オプション) - タイムゾーン (gmt、lst、lst_ldt)
    • format (文字列、オプション) - 出力形式 (json、xml、csv)

現在の予測

• get_current_predictions - 現在の予測を取得する
  • パラメータ:
    • station (文字列) - ステーションID
    • date （文字列、オプション） - データを取得する日付（「今日」、「最新」、「最近」、または特定の日付）
    • begin_date (文字列、オプション) - 開始日 (YYYYMMDD または MM/DD/YYYY)
    • end_date (文字列、オプション) - 終了日 (YYYYMMDD または MM/DD/YYYY)
    • bin (数値、オプション) - ビン番号
    • interval (文字列、オプション) - 間隔 (MAX_SLACK または分単位の数値)
    • vel_type (文字列、オプション) - 速度タイプ (speed_dir または default)
    • units （文字列、オプション） - 使用する単位（「英語」または「メートル法」）
    • time_zone (文字列、オプション) - タイムゾーン (gmt、lst、lst_ldt)
    • format (文字列、オプション) - 出力形式 (json、xml、csv)

気象データ

• get_meteorological_data - 気象データを取得する
  • パラメータ:
    • station (文字列) - ステーションID
    • product (文字列) - 製品（気温、風など）
    • date （文字列、オプション） - データを取得する日付（「今日」、「最新」、「最近」、または特定の日付）
    • begin_date (文字列、オプション) - 開始日 (YYYYMMDD または MM/DD/YYYY)
    • end_date (文字列、オプション) - 終了日 (YYYYMMDD または MM/DD/YYYY)
    • units （文字列、オプション） - 使用する単位（「英語」または「メートル法」）
    • time_zone (文字列、オプション) - タイムゾーン (gmt、lst、lst_ldt)
    • format (文字列、オプション) - 出力形式 (json、xml、csv)

駅情報

• get_stations - ステーションのリストを取得する
  • パラメータ:
    • type (文字列、オプション) - 観測所の種類 (水位、流速など)
    • units （文字列、オプション） - 使用する単位（「英語」または「メートル法」）
    • format (文字列、オプション) - 出力形式 (json、xml)
• get_station_details - 駅の詳細情報を取得する
  • パラメータ:
    • station (文字列) - ステーションID
    • units （文字列、オプション） - 使用する単位（「英語」または「メートル法」）
    • format (文字列、オプション) - 出力形式 (json、xml)

月の満ち欠け情報

• get_moon_phase - 特定の日付の月齢情報を取得する
  • パラメータ:
    • date (文字列、オプション) - 月の満ち欠けを取得する日付（YYYY-MM-DD形式）。デフォルトは現在の日付です。
    • latitude （数値、オプション） - 場所固有の計算のための緯度
    • longitude （数値、オプション） - 場所固有の計算のための経度
    • format (文字列、オプション) - 出力形式 (json またはテキスト)
• get_moon_phases_range - 日付範囲の月齢情報を取得する
  • パラメータ:
    • start_date (文字列) - 開始日 (YYYY-MM-DD 形式)
    • end_date (文字列) - 終了日 (YYYY-MM-DD 形式)
    • latitude （数値、オプション） - 場所固有の計算のための緯度
    • longitude （数値、オプション） - 場所固有の計算のための経度
    • format (文字列、オプション) - 出力形式 (json またはテキスト)
• get_next_moon_phase - 特定の月の満ち欠けの次の発生を取得します
  • パラメータ:
    • phase (文字列) - 検索する月の位相 (新月、上弦、満月、下弦)
    • date (文字列、オプション) - 開始日（YYYY-MM-DD形式）。デフォルトは現在の日付です。
    • count (数値、オプション) - 返される出現回数。デフォルトは1です。
    • format (文字列、オプション) - 出力形式 (json またはテキスト)

日の出・日の入り情報

• get_sun_times - 特定の日付と場所の日の出/日の入りやその他の太陽イベントの時刻を取得します
  • パラメータ:
    • date (文字列、オプション) - 太陽時刻を取得する日付（YYYY-MM-DD形式）。デフォルトは現在の日付です。
    • latitude （数値） - 場所固有の計算のための緯度
    • longitude （数値） - 場所固有の計算のための経度
    • format (文字列、オプション) - 出力形式 (json またはテキスト)
    • timezone (文字列、オプション) - 結果のタイムゾーン。デフォルトは UTC です。
• get_sun_times_range - 日付範囲と場所の日の出/日の入りおよびその他の太陽イベントの時刻を取得します
  • パラメータ:
    • start_date (文字列) - 開始日 (YYYY-MM-DD 形式)
    • end_date (文字列) - 終了日 (YYYY-MM-DD 形式)
    • latitude （数値） - 場所固有の計算のための緯度
    • longitude （数値） - 場所固有の計算のための経度
    • format (文字列、オプション) - 出力形式 (json またはテキスト)
    • timezone (文字列、オプション) - 結果のタイムゾーン。デフォルトは UTC です。
• get_sun_position - 特定の日付、時間、場所の太陽位置情報を取得します
  • パラメータ:
    • date (文字列、オプション) - 太陽の位置を取得する日付（YYYY-MM-DD形式）。デフォルトは現在の日付です。
    • time (文字列, オプション) - 太陽の位置を取得する時刻 (HH:MM:SS 形式)。デフォルトは現在の時刻です。
    • latitude （数値） - 場所固有の計算のための緯度
    • longitude （数値） - 場所固有の計算のための経度
    • format (文字列、オプション) - 出力形式 (json またはテキスト)
• get_next_sun_event - 特定の太陽イベントの次の発生を取得します
  • パラメータ:
    • event (文字列) - 検索する太陽イベント (日の出、日の入り、夜明け、夕暮れ、正午など)
    • date (文字列、オプション) - 開始日（YYYY-MM-DD形式）。デフォルトは現在の日付です。
    • latitude （数値） - 場所固有の計算のための緯度
    • longitude （数値） - 場所固有の計算のための経度
    • count (数値、オプション) - 返される出現回数。デフォルトは1です。
    • format (文字列、オプション) - 出力形式 (json またはテキスト)
    • timezone (文字列、オプション) - 結果のタイムゾーン。デフォルトは UTC です。

APIドキュメント

NOAA 潮汐と海流の API ドキュメントは次の場所にあります。

• CO-OPS データ API: https://api.tidesandcurrents.noaa.gov/api/prod/
• CO-OPS メタデータ API: https://api.tidesandcurrents.noaa.gov/mdapi/prod/
• CO-OPS 派生製品 API: https://api.tidesandcurrents.noaa.gov/dpapi/prod/

FastMCPについて

FastMCPは、クライアントセッションを処理できるMCPサーバーを構築するためのTypeScriptフレームワークです。以下の機能を提供します。

• シンプルなツール、リソース、プロンプトの定義
• セッション
• 画像コンテンツ
• ログ記録
• エラー処理
• 南南東
• 進捗通知
• 型付きサーバーイベント
• その他

詳細については、 https://github.com/punkpeye/fastmcpをご覧ください。

ライセンス

マサチューセッツ工科大学