Surf MCP Server
サーフィンMCPサーバー
サーフィンやウェブをする人のための MCP サーバー。
図
Related MCP server: BC Water Tides MCP Server
ビデオデモ
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-mcpuv を使用して依存関係をインストールします。
uv sync注: プロジェクトでは依存関係の管理に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 ファイルに追加します。
{
"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キーが見つからないか無効です
ネットワークタイムアウト
Available Tools
1 toolget_tidesB
Get tide information for a specific location and date.
Args:
latitude: Float value representing the location's latitude
longitude: Float value representing the location's longitude
date: Date string in YYYY-MM-DD format
Returns:
Formatted string containing tide information and station details
| Name | Required | Description | Default |
|---|---|---|---|
| latitude | Yes | ||
| longitude | Yes | ||
| date | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. While it mentions what the tool returns ('Formatted string containing tide information and station details'), it lacks critical behavioral context such as rate limits, error conditions, authentication requirements, or whether this is a read-only operation. The description provides basic output format but misses important operational details.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is perfectly structured and concise. It begins with a clear purpose statement, then provides organized sections for arguments and returns with specific formatting details. Every sentence adds value, and the information is front-loaded with the most important details first.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 3-parameter tool with no annotations and no output schema, the description provides adequate but incomplete coverage. It explains parameters well and gives output format, but lacks behavioral context like error handling, rate limits, or authentication requirements. The absence of an output schema means the description should ideally provide more detail about the return structure beyond 'formatted string.'
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description provides excellent parameter semantics despite 0% schema description coverage. It clearly explains each parameter's purpose: 'Float value representing the location's latitude/longitude' and 'Date string in YYYY-MM-DD format.' This fully compensates for the lack of schema descriptions and adds meaningful context beyond what the bare schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Get tide information for a specific location and date.' It uses a specific verb ('Get') and resource ('tide information'), and specifies the scope ('for a specific location and date'). However, with no sibling tools provided, there's no opportunity to differentiate from alternatives, preventing a perfect score of 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, prerequisites, or constraints. It simply states what the tool does without any context about appropriate usage scenarios. With no siblings listed, this omission is less critical but still represents a gap in guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as retrieving tide information for a specific location and date, making it distinct by default.
The single tool follows a clear verb_noun pattern (get_tides), which is consistent and predictable. Since there are no other tools to compare against, the naming convention is perfectly uniform.
A single tool is too few for a server named 'Surf MCP Server', which implies a broader scope related to surfing or ocean conditions. This minimal toolset feels incomplete and under-scoped for the apparent domain.
The tool surface is severely incomplete for a surfing-related server. While get_tides covers tide information, there are obvious gaps such as wave forecasts, weather data, or surf spot details, which are essential for the domain and will likely cause agent failures.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Find NOAA tide stations and NDBC buoys, fetch tide predictions, currents, and live conditions.
NOAA Tides & Currents — observations, predictions, datums, station metadata
NOAA tides and currents: water levels, tide predictions, currents, met data, flooding, sun and moon
Tides MCP — NOAA Tides and Currents data
Related MCP Servers
- AlicenseDqualityDmaintenanceProvides access to the Timezone By Location API to retrieve timezone information based on geographic location data.1MIT
- FlicenseNot gradedqualityCmaintenanceProvides Canadian tide predictions from the IWLS API, enabling retrieval of 7-day tide forecasts and station listings for monitoring stations across Canada.
- FlicenseNot gradedqualityBmaintenanceMCP server that provides tide predictions, station lookup, and tidal event alerts for US coastal locations using live NOAA data.
- AlicenseNot gradedqualityFmaintenanceProvides NOAA tide predictions and observed water levels, allowing AI agents to query tide stations and current water level data.5MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ravinahp/surf-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server