Clairwave

clairwave-mcp

AI アシスタントに物理的根拠に基づいた海洋音響学を提供する、オープンな MCP サーバーです。

Clairwave は、全球の海底地形と季節ごとの音速プロファイルを用いて検証済みの伝搬モデル（Bellhop、 RAM／放物型方程式）を実行し、リアルタイムの AIS 船舶を追跡し、船舶の 3D 船体モデルを提供します （shipshape）。このサーバーはそれらの機能を Claude、ChatGPT、Gemini、その他すべての MCP クライアントに公開します。これにより、海洋について推論するアシスタントは、推測する代わりに物理計算を実行できます。

すべての結果には、出所（モデル、データソース、run_id）と、プラットフォームで該当する結果をそのまま開くopen_urlが含まれます。 シミュレーション結果には、使用した海底地形、音速プロファイル、海底パラメーターも含まれるため、研究者は MATLAB、Python、その他の環境で実行を再現できます。

エンドポイント（認証不要、キー不要）： https://www.clairwave.com/mcp — Streamable HTTP。

接続

• Claude Code： claude mcp add --transport http clairwave https://www.clairwave.com/mcp
• Claude.ai／Claude Desktop： Settings → Connectors → Add custom connector → 上記の URL
• ChatGPT： Plugins → Clairwave を検索 → +（掲載済みのプラグイン：URL や開発者モードは不要）
• 任意の MCP クライアント： URL を指定してください。サーバーはステートレスで、JSON レスポンスに対応しています

ツール

ツール	機能
get_bathymetry	地点の水深、または方位に沿った測線プロファイル
get_sound_speed_profile	月ごとの季節性 c(z) と海底パラメーター（cp、cs、密度、減衰、堆積物）
run_transmission_loss	方位に沿った RAM 放物型方程式による伝搬損失（TL）。海底地形／SSP／海底データを自動取得し、再現用バンドルを含みます
estimate_detection_range	RAM 実行結果に基づくソナー方程式：連続検知距離、最遠検知距離、距離ごとの信号余剰
run_bellhop_volume	run id の下に保存される 3D Bellhop TL ボリューム（uint8 キューブ＋JSON サイドカーリンク）
vessel_source_level	船舶の放射雑音：広帯域＋1/3 オクターブスペクトル＋発生メカニズムの内訳
search_vessels / vessels_near	名前／MMSI によるリアルタイム AIS 検索、または地点の半径内にいる船舶の検索
get_vessel	リアルタイムの位置／航跡、詳細情報、3D モデル（GLB、船首が +Z）とプラットフォームへのリンク
get_vessel_photo	Wikimedia Commons の写真と帰属表示
resolve_place	地名（港、海峡、海、「Halifax 沖」など）を水域の座標に変換。地名データベース＋OpenStreetMap を使用し、陸地から離れた海側にスナップします
habitat_received_level	固定地点（養魚場、サンゴ礁、水中マイク）で船舶雑音を電力合算。リアルタイムスナップショットまたは 10 分間の履歴系列と、主な寄与船舶を表示します
about	モデル、データソース、制限事項

ライブプラットフォームでの一般的なレイテンシー：海底地形は 0.5 秒、SSP は 0.1°セルごとに初回 6 秒（以降はキャッシュ）、RAM 伝搬損失は 1〜3 秒、検知距離は 1〜3 秒です。

ローカルで実行

pip install "mcp[cli]<2" httpx
python server.py            # streamable HTTP on :8890 (/mcp)
python server.py --stdio    # stdio for local clients
python tests/smoke_client.py

環境変数：CLAIRWAVE_API、CLAIRWAVE_FLEET、CLAIRWAVE_SITE、MCP_PORT。

公開先

• 公式 MCP Registry：io.github.clairwave/clairwave (https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.clairwave/clairwave)
• Claude：Settings > Connectors > Add custom connector、URL は https://www.clairwave.com/mcp、認証不要。
• ChatGPT：Plugins ディレクトリに「Clairwave — Ocean acoustics & live ships」として掲載されています。Clairwave を検索して + をクリックしてください。
• Grok（grok.com/connectors > New > Custom）：同じ URL を貼り付けてください。
• xAI／OpenAI API：{"type": "mcp", "server_url": "https://www.clairwave.com/mcp", "server_label": "clairwave"}。

場所名

すべての位置情報ツールは、lat／lon または place 文字列を受け取ります。名称はまず海事地名辞典（港は港口に、海峡や海は代表的な水域上の地点に解決されます。gazetteer.py に約120件収録）で検索され、その後 OpenStreetMap Nominatim で検索されます。地点が陸地上にある場合、または水深が10 m未満の場合は、十分な水深に達するまで沖合方向へ移動します。レスポンスの location ブロックには、元の地点、スナップ距離と方位、水深が記載されます。resolve_place では同じロジックを直接利用でき、offshore_km を指定して地点をさらに沖へ移動できます。

プロンプトの例

• 「3月のジブラルタルの西50 km地点における音速プロファイルと、音響層深度を教えてください。」
• 「36N 5.5W付近で、深度20 mにある150 Hz、170 dBの音源を、方位090に沿って深度100 mの受信機でどれくらい遠くまで検出できますか？」
• 「冬のハリファックスの北30 kmまで、200 Hzにおける伝搬損失を距離に対して表示してください。」
• 「今、ホルムズ海峡から15 km以内にいる船舶と、その中で最も大きな船の騒音レベルを教えてください。」
• 「49.2N 123.3W付近で400 Hzの3D Bellhopボリュームを実行し、開くためのリンクを教えてください。」

制限とサポート

• サインインは不要です。計算リクエストのプラットフォーム全体の上限は、約20件／分です。
• シミュレーションは気候値に基づいています（月ごとの音速、全球の海底地形）。現地での測定の代わりにはなりません。
• プライバシーポリシー：PRIVACY.md。利用規約：TERMS.md。サポート：[email protected]。 イシュー：https://github.com/clairwave/clairwave-mcp/issues

ライセンス

MIT。データ：AISHubピアネットワーク経由のAIS（Clairwaveも受信機を提供）；船舶写真はクレジット表記付きのCCライセンス；海底地形とSSPの出典は各レスポンスに記載されています。