🚀 冲浪 MCP 服务器
本项目为冲浪爱好者和网络冲浪人群提供MCP服务，帮助大家获取潮汐信息，从而更好地规划冲浪活动。
🚀 快速开始
先决条件
- Python 3.x
- Storm Glass API密钥
获取你的Storm Glass API密钥
- 访问 Storm Glass
- 点击“免费试用”或“登录”以创建账户
- 注册后，你将收到API密钥
⚠️ 重要提示
API使用存在限制：
- 免费层：每天10个请求
- 已用计划可选：
- 小型：500次/天（€19/月）
- 中型：5000次/天（€49/月）
- 大型：25,000次/天（€129/月）
- 企业：定制计划可选
根据你的使用需求选择合适的计划。免费层适合测试和个人用途。
安装
- 克隆仓库：
git clone https://github.com/ravinahp/surf-mcp.git
cd surf-mcp
- 使用uv安装依赖项：
uv sync
⚠️ 重要提示
我们使用
uv而不是pip，因为项目使用pyproject.toml进行依赖管理。
配置
- 命令：
uv - 参数：需要填写API密钥和路径
使用说明
- 该工具提供潮汐信息查询功能，支持按日期查询特定时间的潮汐情况。
- 示例：在终端中输入以下命令以获取当前时间的潮汐数据：
uv [api-key] [path]
✨ 主要特性
- 使用纬度和经度获取任何位置的潮汐信息
- 支持按日期查询特定潮汐信息
- 详细的潮汐数据，包括高低潮汐和站信息
- 自动时区处理（UTC）
📦 安装指南
- 克隆仓库：
git clone https://github.com/ravinahp/surf-mcp.git
cd surf-mcp
- 使用uv安装依赖项：
uv sync
💻 使用示例
基础用法
在终端中输入以下命令以获取当前时间的潮汐数据：
uv [api-key] [path]
高级用法
你可以使用此工具确定你喜欢的海滩的最佳冲浪时间。通常，最佳冲浪条件是在涨潮（Incoming tide）期间，大约在高潮前2小时。
⚠️ 重要提示
不同海滩的最佳冲浪条件可能因地理位置和破浪类型而异。此工具还提供站距信息，当你使用时也应考虑这一点（即较长的站距意味着更高的不准确度）。
📚 详细文档
错误处理
服务包含 robust 的错误处理机制，包括：
- API请求失败
- 无效坐标
- 缺失或无效API密钥
- 网络超时
📊 图表
🎬 视频演示
https://github.com/user-attachments/assets/0a4453e2-66df-4bf5-8366-8538cda366ed