Surf MCP

🚀 サーフィンMCPサーバー

サーフィンやネットサーフィンを楽しむ人々にMCPサービスを提供します。

📊 チャート

🎥 ビデオデモ

https://github.com/user-attachments/assets/0a4453e2-66df-4bf5-8366-8538cda366ed

✨ 主な機能

• 緯度と経度を使用して、任意の場所の潮汐情報を取得できます。
• 日付指定で特定の潮汐情報を照会することができます。
• 高低潮や観測所情報を含む詳細な潮汐データを提供します。
• 自動的にタイムゾーン（UTC）を処理します。

📋 前提条件

• Python 3.x
• Storm Glass APIキー

🔑 Storm Glass APIキーの取得方法

1. Storm Glassにアクセスします。
2. 「無料トライアル」または「ログイン」をクリックしてアカウントを作成します。
3. 登録後、APIキーが発行されます。

⚠️ 重要提示

APIの使用制限について：

• 無料プラン：1日10リクエスト
• 有料プラン：
  • 小型：500回/日（€19/月）
  • 中型：5000回/日（€49/月）
  • 大型：25,000回/日（€129/月）
  • エンタープライズ：カスタムプラン

使用目的に合わせたプランを選択してください。無料プランはテストや個人利用に適しています。

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/ravinahp/surf-mcp.git
cd surf-mcp

2. uvを使用して依存関係をインストールします：

uv sync

⚠️ 重要提示

このプロジェクトではpyproject.tomlを使用して依存関係を管理しているため、uvを使用しています。

⚙️ 設定

• コマンド：uv
• パラメータ：APIキーとパスを入力する必要があります。

💻 使用例

基本的な使用法

このツールは潮汐情報の照会機能を提供し、日付指定で特定の時間の潮汐状況を照会することができます。

uv [api-key] [path]

🔧 エラー処理

このサービスには堅牢なエラー処理機構が備わっており、以下のエラーを処理できます：

• APIリクエスト失敗
• 無効な座標
• 欠落または無効なAPIキー
• ネットワークタイムアウト

💡 サンプル #1：最適なサーフィン時間の検索

このツールを使用して、お気に入りのビーチの最適なサーフィン時間を特定できます。通常、最適なサーフィン条件は満潮前約2時間の潮上がりの間です。

⚠️ 重要提示

異なるビーチでは、最適なサーフィン条件が地理的位置や波の種類によって異なる場合があります。このツールは観測所までの距離の情報も提供していますので、使用する際にはこの点も考慮してください（観測所までの距離が長いほど、精度が低くなります）。