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