サーフィンMCPサーバー

サーフィンやウェブをする人のための MCP サーバー。

図

ビデオデモ

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 ユーロ)
- エンタープライズ: カスタムプランも利用可能

ご利用要件に応じてプランをお選びください。無料プランはテストや個人利用に適しています。

インストール

リポジトリをクローンします。

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

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

uv sync

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

MCPサーバーとして構成する

このツールをMCPサーバーとして追加するには、Claudeデスクトップの設定ファイルを変更する必要があります。この設定にはStorm Glass APIキーが含まれているため、別途設定する必要はありません。

構成ファイルの場所は、オペレーティングシステムによって異なります。

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

次の構成を JSON ファイルに追加します。

{
    "surf-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/Users/YOUR_USERNAME/Code/surf-mcp",
            "run",
            "surf-mcp"
        ],
        "env": {
            "STORMGLASS_API_KEY": "your_api_key_here"
        }
    }
}

⚠️ 重要:

YOUR_USERNAME実際のシステムユーザー名に置き換えます
your_api_key_here実際の Storm Glass API キーに置き換えます。
ディレクトリパスがローカルインストールと一致していることを確認してください

展開

建物

パッケージを準備するには:

依存関係を同期し、ロックファイルを更新します。

uv sync

ビルドパッケージ:

uv build

これにより、 dist/ディレクトリにディストリビューションが作成されます。

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグエクスペリエンスを得るには、MCP Inspectorの使用を強くお勧めします。

次のコマンドで MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/surf-mcp run surf-mcp

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

検査官は以下を提供します:

リアルタイムのリクエスト/レスポンス監視
入力/出力検証
エラー追跡
パフォーマンス指標

使用法

このサービスでは、潮汐情報を取得するための FastMCP ツールを提供しています。

@mcp.tool()
async def get_tides(latitude: float, longitude: float, date: str) -> str:
    """Get tide information for a specific location and date."""

パラメータ:

latitude : 場所の緯度を表す浮動小数点値
longitude : 場所の経度を表す浮動小数点値
date : YYYY-MM-DD形式の日付文字列

応答例:

Tide Times:
Time: 2024-01-20T00:30:00+00:00 (UTC)
Type: HIGH tide
Height: 1.52m

Time: 2024-01-20T06:45:00+00:00 (UTC)
Type: LOW tide
Height: 0.25m

Station Information:
Name: Sample Station
Distance: 20.5km from requested location

ユースケース

例1：サーフィンに最適な時間を見つける

このツールを使えば、お気に入りのビーチと最寄りのステーションでサーフィンに最適な時間を調べることができます。一般的に、サーフィンに最適なコンディションは、満潮の約2時間前の上げ潮時です。

クロードへのプロンプトの例:

注：ビーチによって、地形や波の種類によって最適な潮汐条件が異なる場合があります。このツールは、潮汐情報と併せて考慮すべき測点距離情報も提供します。（測点距離が長いほど、不正確さが増します。クロードに質問する際に、この点についても尋ねることができます。）

エラー処理

このサービスには、次のような堅牢なエラー処理が含まれています。

APIリクエストの失敗
無効な座標
APIキーが見つからないか無効です
ネットワークタイムアウト

Surf MCP Server

Integrations