NOAA Tides MCP Server

NOAA Tides MCP Server

この MCP サーバーは、Model Context Protocol を通じて NOAA CO-OPS（Center for Operational Oceanographic Products and Services）のデータにアクセスできます。

機能

• 特定の観測所の水位データを取得します
• 潮汐予測（満潮・干潮）を取得します
• 観測所の情報とメタデータを取得します

インストール

uv add mcp[cli]
uv add httpx

開発環境のセットアップ

テスト用の依存関係を含む開発環境をセットアップするには、次を実行します。

# Install test dependencies
uv add pytest pytest-asyncio pytest-httpx pytest-mock

テスト

このプロジェクトでは、テストに pytest を使用します。テストスイートには次の内容が含まれます。

• すべての API エンドポイントの単体テスト
• エラー処理のテスト
• パラメーター検証のテスト
• pytest-httpx を使用した HTTP レスポンスのモック

テストを実行するには、次を実行します。

# Run all tests with verbose output
pytest -v

# Run a specific test file
pytest tests/test_server.py -v

# Run a specific test function
pytest tests/test_server.py::test_get_water_levels -v

使い方

このサーバーでは、主に次の 3 つのツールを利用できます。

1. get_water_levels：特定の観測所の水位データを取得します

   • パラメーター：
     • station_id：7 桁の観測所 ID
     • begin_date：開始日（yyyyMMdd 形式、省略可）
     • end_date：終了日（yyyyMMdd 形式、省略可）
     • datum：鉛直基準面（デフォルト：MLLW）
     • time_zone：タイムゾーン（デフォルト：gmt）
     • units：測定単位（デフォルト：english）

2. get_tide_predictions：特定の観測所の潮汐予測を取得します

   • パラメーター：
     • station_id：7 桁の観測所 ID
     • begin_date：開始日（yyyyMMdd 形式、省略可）
     • end_date：終了日（yyyyMMdd 形式、省略可）
     • datum：鉛直基準面（デフォルト：MLLW）
     • time_zone：タイムゾーン（デフォルト：gmt）
     • units：測定単位（デフォルト：english）
     • interval：予測間隔（デフォルト：満潮・干潮を示す hilo）

3. get_station_info：特定の観測所に関する情報を取得します

   • パラメーター：
     • station_id：7 桁の観測所 ID

観測所 ID の例

• 9414290：サンフランシスコ、カリフォルニア州
• 8518750：バッテリー、ニューヨーク州
• 8557863：リホボスビーチ、メリーランド州

サーバーの実行

python server.py

Claude Desktop での使用

このサーバーを Claude Desktop で使用するには、次の設定文字列を追加します。

python:/path/to/your/server.py

/path/to/your/server.py を、実際の server.py ファイルのパスに置き換えてください。

ライセンス

MIT