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

図

##ビデオデモ [https://github.com/user-attachments/assets/0a4453e2-66df-4bf5-8366-8538cda366ed]

##特徴

• 緯度と経度を使用して任意の場所のためのフェッチ潮情報
• 日付固有の潮汐クエリのサポート
• 高/低潮および場所情報を含む詳細な潮汐データ
• 自動タイムゾーン処理(UTC)

前提条件

• Python 3.xの
• 嵐ガラスAPIキー

Storm ガラス API キーの取得

1. 嵐のガラスを訪問して下さい
2. 「無料配送」または「サインイン」をクリックしてアカウントを作成 3。 登録したら、APIキーを受け取る

API の使用制限に注意してください。

• 無料ティア:1日10リクエスト
• 有料プラン:
• 小:500リクエスト/日(€19 /月)
• 媒体:5000の要求/日(€49/month)
• 大きい:25,000の要求/日(€129/month)
• 企業:利用できる注文の計画

ご利用条件に基づくプランを選択してください。 自由な層はテストおよび個人的な使用のために適しています。

インストール

1. リポジトリのクローン化:

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

Note: プロジェクトが依存関係管理のために pyproject.toml] を使用するので pip の代わりに uv を使用します。

MCP Server の設定

Surf MCP Server

MCP server for people who surf waves and the web.

Diagram

Video Demo

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

Features

• Fetch tide information for any location using latitude and longitude
• Support for date-specific tide queries
• Detailed tide data including high/low tides and station information
• Automatic time zone handling (UTC)

Prerequisites

• Python 3.x
• Storm Glass API key

Getting Your Storm Glass API Key

1. Visit Storm Glass
2. Click “Try for Free” or “Sign In” to create an account
3. Once registered, you’ll receive your API key

Note on API Usage Limits:

• Free tier: 10 requests per day
• Paid plans available:
  • Small: 500 requests/day (€19/month)
  • Medium: 5000 requests/day (€49/month)
  • Large: 25,000 requests/day (€129/month)
  • Enterprise: Custom plans available

Choose a plan based on your usage requirements. The free tier is suitable for testing and personal use.

Installation

1. Clone the repository:

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

2. Install dependencies using uv:

uv sync

Note: We use uv instead of pip since the project uses pyproject.toml for dependency management.

Configure as MCP Server

To add this tool as an MCP server, you’ll need to modify your Claude desktop configuration file. This configuration includes your Storm Glass API key, so you won’t need to set it up separately.

The configuration file location depends on your operating system:

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

Add the following configuration to your JSON file:

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

⚠️ IMPORTANT:

1. Replace YOUR_USERNAME with your actual system username
2. Replace your_api_key_here with your actual Storm Glass API key
3. Make sure the directory path matches your local installation

Deployment

Building

To prepare the package:

1. Sync dependencies and update lockfile:

uv sync

2. Build package:

uv build

This will create distributions in the dist/ directory.

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector with this command:

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