Surf MCP

🚀 衝浪 MCP 服務器

本項目為衝浪愛好者和網絡衝浪人群提供MCP服務，幫助大家獲取潮汐信息，從而更好地規劃衝浪活動。

🚀 快速開始

先決條件

• Python 3.x
• Storm Glass API密鑰

獲取你的Storm Glass API密鑰

1. 訪問 Storm Glass
2. 點擊“免費試用”或“登錄”以創建賬戶
3. 註冊後，你將收到API密鑰

⚠️ 重要提示

API使用存在限制：

• 免費層：每天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

⚠️ 重要提示

我們使用uv而不是pip，因為項目使用pyproject.toml進行依賴管理。

配置

• 命令：uv
• 參數：需要填寫API密鑰和路徑

使用說明

• 該工具提供潮汐信息查詢功能，支持按日期查詢特定時間的潮汐情況。
• 示例：在終端中輸入以下命令以獲取當前時間的潮汐數據：

uv [api-key] [path]

✨ 主要特性

• 使用緯度和經度獲取任何位置的潮汐信息
• 支持按日期查詢特定潮汐信息
• 詳細的潮汐數據，包括高低潮汐和站信息
• 自動時區處理（UTC）

📦 安裝指南

1. 克隆倉庫：

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

2. 使用uv安裝依賴項：

uv sync

💻 使用示例

基礎用法

在終端中輸入以下命令以獲取當前時間的潮汐數據：

uv [api-key] [path]

高級用法

你可以使用此工具確定你喜歡的海灘的最佳衝浪時間。通常，最佳衝浪條件是在漲潮（Incoming tide）期間，大約在高潮前2小時。

⚠️ 重要提示

不同海灘的最佳衝浪條件可能因地理位置和破浪類型而異。此工具還提供站距信息，當你使用時也應考慮這一點（即較長的站距意味著更高的不準確度）。

📚 詳細文檔

錯誤處理

服務包含 robust 的錯誤處理機制，包括：

• API請求失敗
• 無效座標
• 缺失或無效API密鑰
• 網絡超時

📊 圖表

🎬 視頻演示

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