核心用法
Tides 是一项基于 JSON-RPC 2.0 协议构建的全球海洋潮汐数据服务,通过 https://hamandmore.net/api/harmonics/mcp 端点提供 RESTful 风格的 API 调用。该技能封装了四大核心功能模块:
1. 实时潮高查询 (`tides_single`):输入经纬度与 ISO 8601 时间戳,返回指定位置的精确潮高数值
2. 潮汐极值预测 (`tides_extrema`):查询给定时间段内的涨潮/退潮极值点,支持24小时周期规划
3. 服务器时间同步 (`tides_time`):获取服务端当前时间,用于校准本地时间偏差
4. 网格气象数据 (`weather_met`):获取海表风场、温度等多变量气象数据,辅助综合海况判断
调用方式灵活,支持匿名访问(受速率限制)与 Token 认证两种模式,采用标准 HTTP POST 请求,响应结果以结构化 JSON 或字符串形式返回。
显著优点
- 全球覆盖:基于调和常数模型,理论上覆盖全球任意海岸线坐标点
- 协议标准化:严格遵循 JSON-RPC 2.0 规范,便于集成至各类 MCP 客户端与自动化工作流
- 多场景适用:航海导航、赶海拾贝、冲浪选址、港口调度、海岸线工程勘察均可受益
- 实时气象融合:潮汐数据与气象变量(风速、海表温度)联动查询,提升决策维度
潜在缺点与局限性
- 数据源透明度不足:文档未明确标注采用的潮汐模型版本(如 FES2014、TPXO 等)及精度等级
- 认证机制特殊:
Basic前缀为自定义 Token 标识,非 RFC 7617 标准 Base64 编码,易造成开发者误解 - 无 SLA 承诺:免费匿名 tier 存在未公开的速率限制,商业级稳定性存疑
- 网格气象未说明分辨率:
weather_met的空间与时间分辨率参数未在文档中披露
适合人群
- 沿海活动爱好者(冲浪、潜水、赶海)
- 小型船舶驾驶员与游艇俱乐部成员
- 海洋科研人员与港口调度员
- 需要潮汐数据增强的 AI 助手开发者
常规风险
- API 服务连续性:由个人域名 (
hamandmore.net) 托管,缺乏企业级基础设施背书,存在服务中断或域名变更风险 - 数据准确性责任:潮汐预测受局部地形、气象突变影响,不建议作为唯一安全决策依据,关键航行应交叉验证官方海事机构数据
- 隐私与 Token 安全:Token 传输虽经 HTTPS 加密,但长期静态 Token 若泄露可能导致配额滥用,建议定期轮换