サーフィンMCPサーバー
サーフィンやウェブをする人のための MCP サーバー。
図
Related MCP server: HRFCO Service
ビデオデモ
https://github.com/user-attachments/assets/0a4453e2-66df-4bf5-8366-8538cda366ed
特徴
緯度と経度を使用して任意の場所の潮汐情報を取得します
日付指定の潮汐クエリのサポート
満潮・干潮や観測所情報を含む詳細な潮汐データ
自動タイムゾーン処理（UTC）
前提条件
Python 3.x
ストームグラスAPIキー
ストームグラスAPIキーの取得
ストームグラスを訪問
「無料で試す」または「サインイン」をクリックしてアカウントを作成してください
登録するとAPIキーが届きます
API 使用制限に関する注意:
無料枠: 1日あたり10リクエスト
利用可能な有料プラン:
小規模: 1日あたり500リクエスト (月額19ユーロ)
中規模: 5000 リクエスト/日 (月額 49 ユーロ)
大規模: 25,000 リクエスト/日 (月額 129 ユーロ)
エンタープライズ: カスタムプランも利用可能
ご利用要件に応じてプランをお選びください。無料プランはテストや個人利用に適しています。
インストール
リポジトリをクローンします。
uv を使用して依存関係をインストールします。
注: プロジェクトでは依存関係の管理にpyproject.toml使用しているため、pip ではなくuvを使用します。
MCPサーバーとして構成する
このツールをMCPサーバーとして追加するには、Claudeデスクトップの設定ファイルを変更する必要があります。この設定にはStorm Glass APIキーが含まれているため、別途設定する必要はありません。
構成ファイルの場所は、オペレーティング システムによって異なります。
MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.json
次の構成を JSON ファイルに追加します。
⚠️ 重要:
YOUR_USERNAME実際のシステムユーザー名に置き換えますyour_api_key_here実際の Storm Glass API キーに置き換えます。ディレクトリパスがローカルインストールと一致していることを確認してください
展開
建物
パッケージを準備するには:
依存関係を同期し、ロックファイルを更新します。
ビルドパッケージ:
これにより、 dist/ディレクトリにディストリビューションが作成されます。
デバッグ
MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグエクスペリエンスを得るには、MCP Inspectorの使用を強くお勧めします。
次のコマンドで MCP Inspector を起動できます。
起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。
検査官は以下を提供します:
リアルタイムのリクエスト/レスポンス監視
入力/出力検証
エラー追跡
パフォーマンス指標
使用法
このサービスでは、潮汐情報を取得するための FastMCP ツールを提供しています。
パラメータ:
latitude: 場所の緯度を表す浮動小数点値longitude: 場所の経度を表す浮動小数点値date: YYYY-MM-DD形式の日付文字列
応答例:
ユースケース
例1：サーフィンに最適な時間を見つける
このツールを使えば、お気に入りのビーチと最寄りのステーションでサーフィンに最適な時間を調べることができます。一般的に、サーフィンに最適なコンディションは、満潮の約2時間前の上げ潮時です。
クロードへのプロンプトの例:
注：ビーチによって、地形や波の種類によって最適な潮汐条件が異なる場合があります。このツールは、潮汐情報と併せて考慮すべき測点距離情報も提供します。（測点距離が長いほど、不正確さが増します。クロードに質問する際に、この点についても尋ねることができます。）
エラー処理
このサービスには、次のような堅牢なエラー処理が含まれています。
APIリクエストの失敗
無効な座標
APIキーが見つからないか無効です
ネットワークタイムアウト