Gillby

Gillby MCP

为 AI Agent 提供佛罗里达州海洋状况。通过一个远程 MCP 服务和公共 HTTP API，获取潮汐、海浪、风、海洋预报、灾害、赤潮、离岸流、考虑水深的船只路线规划，以及 84 个经过核实的沿海地点。

将任何兼容 MCP 的 Agent（Claude、ChatGPT、Cursor、Windsurf、Claude Code）连接到 Gillby，这是一个佛罗里达水域指南。公共数据无需 API 密钥、无需登录、无需注册：让你的 Agent 访问 https://www.gillby.com/mcp，然后提问即可。

Gillby 的由来

我刚开始接触船艇。我不是佛罗里达人，但在这里已经住了好几年。最先提出这个问题的是我妻子：想要了解天气状况，却得查五个不同的地方，实在太麻烦；而我们问 AI 时，它自己也给不出好答案。

于是我做了 Gillby。这是一个兴趣项目，也是我倾注热情的作品：用一张地图和一个时钟，了解在佛罗里达水域出行一天的状况；此外，我还做了这个 MCP 服务，让你的助手能依据真实水域数据回答，而不是凭空猜测。更多内容请见我为什么构建 Gillby。

“明天早上可以从 Boca Inlet 出航吗？”·“Palm Beach 外海的墨西哥湾流近吗？”·“墨西哥湾沿岸有赤潮吗？”·“退潮时，我这艘吃水 2.5 ft 的船能到达沙洲吗？”

与众不同之处

• **一张地图，一个时钟。**风、海浪、潮汐、雷达和闪电信息按地点排列在同一时间线上。
• **按你的船评估颠簸程度。**舒适度评估会考虑船只尺寸和船体，因此，21 英尺的中控台式快艇与大型运动钓鱼艇得到的答案会有所不同。
• **根据今天的潮汐评估桥梁净空。**涵盖 97 座桥梁；在通过校验的情况下，根据 NOAA 潮汐预测和最近的实时水位观测站数据调整海图标注的净空。
• **经校准的降雨和雷暴概率。**根据机场观测重新校准概率，让给出的概率符合实际降雨频率。
• **16 天展望，并如实说明可信度。**提供集合预报范围和相对于常年的趋势。从第 10 天起，每天都会标注“可信度低：仅供参考趋势”。
• **每条信息都附有来源。**每个答案都包含来源名称、观测时间、数据新鲜度，以及任何不可用的信息。

端点

https://www.gillby.com/mcp

采用可流式传输的 HTTP 传输方式。

访问方式	可获取内容
公开访问，无需密钥	状况、预报、潮汐、灾害、水质、地点与场所、活动评分，以及最近 72 小时的历史数据。每个客户端每分钟 300 单位。
免费 Gillby 账户（OAuth）	所有公开内容，另加考虑水深的路线规划（plan_route、plan_my_route）、已保存的船只、场所与行程、最长 31 天的历史数据，以及每分钟 1,500 单位。
商业用途或批量使用	需另行签约：[email protected]

快速连接

Claude（claude.ai 和 Claude Desktop）

1. 打开 Settings，然后选择 Connectors。选择 Add connector，再选择 Add custom connector。
2. 将 Gillby 填为名称，并粘贴上方的服务 URL。公开条件下选择无需登录，然后选择 Add and Connect。
3. 启用 Gillby 并开始新对话，在收到提示时批准工具使用。

在 claude.ai 上添加的连接器也会显示在 Claude Desktop 中。

ChatGPT

1. 打开 Plugins（部分账户中称为 Apps 或 Connectors）。选择 Add，再选择 Add custom MCP server。工作区可能需要管理员权限。
2. 将 Gillby 填为名称，粘贴服务 URL，并在公开条件下选择 No authentication。创建后选择 Connect。
3. 开始新聊天，并从工具中选择 Gillby。

Claude Code

claude mcp add --transport http gillby https://www.gillby.com/mcp

Cursor / Windsurf — 添加到 MCP 配置中：

{
  "mcpServers": {
    "gillby": { "type": "http", "url": "https://www.gillby.com/mcp" }
  }
}

试试看：“使用 Gillby 检查 Boca Inlet 的当前状况。注明数据来源的新鲜度以及任何不可用的数据。” 完整步骤和故障排除说明：连接指南。

Claude Code 插件

此仓库也是一个 Claude Code 插件：包含 Gillby MCP 服务，以及 9 个技能和 6 个 Agent。

/plugin marketplace add OneWave-AI/gillby-mcp
/plugin install gillby@gillby

在 Claude Code 2.1.275+ 中只需一步：/plugin install gillby --marketplace OneWave-AI/gillby-mcp。

Agent 和评测会以 mcp__plugin_gillby_gillby__<tool> 的形式调用工具。如果你也将 Gillby 连接为 claude.ai 连接器，相同的工具会出现两次；配合这些技能使用时，两者都可以正常工作。

技能	用途
gillby-conditions	获取任意地点的实时读数、比较地点
gillby-go-no-go	结合出发时间段，判断是否适合划船、钓鱼或前往海湾入口
gillby-route	仅限 ICW 的航线规划，考虑水深、潮汐和桥梁
gillby-fishing	墨西哥湾暖流、温度锋面、水色、礁区、沉船、潮汐
gillby-beach-day	游泳、离岸流风险、细菌、马尾藻、水母、UV
gillby-dive	能见度、水流、潜水地点、保护区
gillby-surf-kite	冲浪、SUP、风筝冲浪（骑手风速范围）、skim、划桨
gillby-water-quality	赤潮、藻类、Lake O、排放、鱼类死亡
gillby-account	已保存地点、行程、船只、设置（OAuth）

Agent	职责
gillby-captain	行程规划，判断可以出行 / 谨慎出行 / 不宜出行
gillby-navigator	海图、水深、桥梁、搁浅风险
gillby-fishing-guide	近海和近岸钓鱼条件
gillby-beach-scout	挑选适合游泳、冲浪、风筝冲浪、浮潜的最佳海滩
gillby-surf-guide	佛罗里达州和受支持的加利福尼亚州地点的冲浪时段
gillby-water-quality-analyst	对带日期的水质记录进行说明

评测

evals/ 包含 6 个案例（地点状况、是否适合出行、路线询问吃水深度、风筝冲浪询问风速范围、禁止下水且不涉水游泳、船长 Agent）。MCP 调用由从实时服务记录的模拟数据作答（evals/mocks/gillby/），因此运行时无需连接 Gillby 网络。

claude plugin eval . --judge-model sonnet

工具

托管服务上有 105 个工具，由实时工具参考生成。可从 list_spots 和 get_conditions（使用 view=summary）开始；该结果会包含预报、潮汐、评分、建议、危险、闪电和数据来源新鲜度。

按类别列出的全部 105 个工具

从这里开始（8）

工具	功能
get_briefing	根据实时数据撰写简短标题和不超过 60 词的正文（数字已与事实表核验；没有可用模型时会回退到模板）。来源注明为 claude/openai/template。受速率限制：缓存未命中时可能会调用 LLM。
get_conditions	获取指定地点的完整条件数据包：当前浪况（英尺、秒、来向角度）、风（节）、潮汐（英尺 MLLW）、水温（华氏度）、活动评分及原因、7 天逐小时预报、高潮/低潮、最佳时段、NWS 警报、离岸流/赤潮/细菌危害、闪电和 AI 简报。风筝冲浪：kiteboarding 包含针对骑手的天气筛查和未经核实的下水点状态；请提供 kiteStyle、kiteExperience、kiteMinWindKt 和 kiteMaxWindKt。此结果不代表综合风筝评分，也不代表下水点已核实。活动包括：kite（风筝冲浪）、surf（冲浪）、skim（平地滑板）、skim-wave（乘浪滑板）、paddle（平水桨板）、sup-surf（SUP 冲浪）。没有海岸线观测数据时，不会提供 skim 评分；请勿用其他活动评分代替。除非需要查看每个小时的数据，否则优先使用 view=summary。boat= 会添加船只专属的颠簸舒适度数据。对于任意经纬度，请使用 get_point_conditions。若要查询地点当前情况并使用 view=summary，请从此处开始：单次结果包含预报、潮汐、评分、公告、危害、闪电和来源状态。除非缺少所需详情，否则避免重复调用危害/潮汐工具。对于海滩相关问题，海洋模型浪高和 NWS 破浪高度的测量对象不同；两者的差异本身并不代表预报冲突。若建议禁止游泳，后续不得再建议涉水。解读时：除非用户提供或确认了船只，否则不要传入 boat。描述闪电时，应说明在指定时段内观测到或未检测到闪电，绝不能保证天气晴朗或安全。即使 freshness.stale=false，也要报告不可用或质检失败的来源；数据新鲜不代表所有来源都可用。海洋模型浪高不等于破浪高度。不同本地 MLLW 测站的潮高不能证明水道的相对水深。高潮时不一定是平潮。风筝冲浪应使用带有 kiteStyle（freeride/waves/foil）、kiteExperience 以及由骑手提供的 kiteMinWindKt/kiteMaxWindKt 的 get_conditions。请查看 kiteboarding 获取天气筛查、阵风差值和明确标注为未经核实的下水点状态。绝不要推断骑手的适宜风速范围、合法下水权限或救援保障。活动键：kite（风筝冲浪）、surf（冲浪）、skim（平地滑板）、skim-wave（乘浪滑板）、paddle（平水桨板）、sup-surf（SUP 冲浪）。没有海岸线观测数据时，skim 适宜度不评分；缺失的评分不得沿用其他活动的评分。离岸风可能有利于冲浪，但会增加桨板漂移风险。单个点位的水深无法证明路线畅通。不要编造检测百分比、未来读数、船只所有权或应用设置说明。
get_data_coverage	已发布数据集清单和经核实的地点覆盖情况；会区分不可用数据。
get_health	汇总摄取工作进程是否运行、哪些数据源类别（ndbc、coops、nws、openmeteo、goes19、coastwatch 等）存在过期来源、政府数据集状态以及 GLM 闪电数据源。status 为 ok | degraded | down；仅在 down 时返回 HTTP 503。在采信其他工具的“无数据”结果前，请先检查此项。detail=true 会列出所有来源。
get_release_updates	读取当前 Gillby 发布版本、日期、支持的 MCP 协议以及 API 和 MCP 共用的带日期变更记录。API URL 版本与产品发布版本分开管理。
get_source_status	获取地点条件数据所用来源的新鲜、过期、不可用及质检拒收状态。
get_spot	获取单个地点记录，以及工作进程已完成评分时的 now.scores（当前小时各活动的 go/caution/nogo 状态）。
list_spots	列出应用评分的所有佛罗里达州命名地点，包括其纬度/经度、类型、区域和对应的 NOAA 测站。请在条件、预报、潮汐、危害和简报工具中使用返回的 id。include=status 会添加各活动当前小时的 go/caution/nogo 等级。要获取已核实沿海地点的地图，请使用此工具：MCP 应用面板会显示佛罗里达州交互式地图，支持选择地点、查看附近摄像头标记和条件。坐标表示地理位置，并非安全导航路线。
Forecast and conditions (23)

工具	功能
compare_spots	比较最多五个以逗号分隔的已验证地点 ID 的当前状况。部分失败会明确显示。
get_activity_scores	每小时发布的活动评分，附带原因和否决项。缺失的活动评分视为未评分。
get_air_temperature	获取已验证地点未来几小时的气温。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_chop	获取已验证地点未来几小时的船体颠簸和海面颠簸情况（查看历史趋势请使用 get_chop_history）。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。查看历史海面颠簸或趋势时，请使用 get_chop_history 并提供已验证的地点 ID。保留记录数据与重建数据的来源信息、原生 0–10 指数及标签、覆盖范围和缺失区间。切勿臆造由助手定义的粗糙/平静阈值，也不要悄悄用波浪/风力序列替代原生海面颠簸数据。
get_chop_history	Gillby 原生 0-10 海面颠簸序列：公开提供最近 72 小时的数据；使用免费的 Gillby 账户（OAuth 登录）可查看最长 31 天的数据；包含每日均值/最大值、覆盖范围和 7 天趋势。记录数据和历史模型重建数据会分别标明。切勿用助手自定义的平静/中等/粗糙阈值替代这些数据，也不要捏造缺失区间。查看历史海面颠簸或趋势时，请使用 get_chop_history 并提供已验证的地点 ID。保留记录数据与重建数据的来源信息、原生 0–10 指数及标签、覆盖范围和缺失区间。切勿臆造由助手定义的粗糙/平静阈值，也不要悄悄用波浪/风力序列替代原生海面颠簸数据。
get_cloud_cover	获取已验证地点未来几小时的云量。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_currents	获取已验证地点未来几小时的预测入海口水流。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_departure_windows	按活动筛选已发布的最佳出行时段。没有时段表示未提供相关时段，并不保证其他所有时段都不安全。
get_forecast	获取地点（或 lat+lon）从 time（默认当前时间）开始、持续 hours 小时的逐小时预报：海浪、涌浪/风浪细分、风、阵风、潮汐、水流、降水/雷暴概率，以及各项活动的 go/caution/nogo 评分和原因。还会返回 7 行每日评分和最佳时段。
get_gulf_stream	获取已验证地点附近墨西哥湾流边缘的大致位置。保留来源采样日期和不可用状态。卫星清晰度是相对指数，并非实测潜水能见度。
get_history	读取来源和变量的已存观测数据或预报历史。预报来源使用 forecast:model，且必须提供地点。公开访问范围为最近 72 小时；使用免费的 Gillby 账户（OAuth 登录）可查询最长 31 天的时间窗口；最多 1000 个数据点。采用最新修订版/运行结果。已排除被拒绝和可疑的数据行；未审核的数据行仍保留质量元数据。这是已存来源档案。source=forecast:* 返回模型估算值或预测值，即使有效时间已过；不能据此确认降雨实测情况。如需历史每日实测降水量，请使用 get_rainfall_history 并保留覆盖范围。如需查看海面颠簸趋势，请使用 get_chop_history，并保留记录数据/重建数据的来源信息和缺失区间。
get_observations	获取地点的实际浮标和站点观测数据及时间戳。这些数据可能与融合预报状况不同。
get_pressure	获取已验证地点未来几小时的气压。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_rain	获取已验证地点未来几小时的降雨概率和降雨量预报。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_rainfall_history	获取 NOAA NCEI GHCN-Daily 在六个选定佛罗里达机场站点之一的每日实测降水量，不是已存档的预报。必须提供站点、开始日期和结束日期（YYYY-MM-DD）；仅包含已完成的日期，范围从 1900 年起，每次请求最多涵盖 366 个连续日期。公开可用，无需 API 密钥。返回以英寸为单位的每日数值、原始标志、覆盖范围、月度摘要和总量。覆盖范围不完整时，totalIn 为 null；partialTotalIn 仅为已接受的报告值之和。微量降水不等于无降水。推定为零、时段不完整以及带质量标志的报告均会排除。报告日期是站点气候日，并非 UTC 小时。站点测量值不代表附近海滩、入海口或整个区域的降雨量。近期记录可能延迟发布或被修订。用于查询实际降水量：NOAA 站点实测记录，而非预报档案。保留站点、报告日期、微量降水日、缺失/排除数量和覆盖范围。切勿将 partialTotalIn 表述为完整的月度/年度总量。站点降雨量并非区域范围的测量值。未来降雨量请使用 get_rain；仅在查询已存档的模型估算值时使用 get_history source=forecast:om_weather_best var=precip_in。
get_surf_forecast	获取已验证地点的 NWS 冲浪区预报。保留来源采样日期和不可用状态。卫星清晰度是相对指数，并非实测潜水能见度。
get_thunder_forecast	获取已验证地点未来几小时的雷暴预报。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_uv_forecast	获取已验证地点未来几小时的 UV 预报。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_visibility	获取已验证地点未来几小时的大气能见度。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_water_temperature	获取已验证地点未来几小时的水温。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_wave_models	获取地点的已发布波浪模型序列和模型分歧范围；缺失的模型仍标记为不可用。
get_waves	获取已验证地点未来几小时的波高、周期和涌浪。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
get_wind	获取已验证地点未来几小时的风和阵风。包含时间戳、来源状态；数据不可用时会明确显示 null。水温单位为 F；大气能见度单位为 mi，并非水下能见度；流向正负号遵循指定站点的惯例。
潮汐、灾害与警报（11）
工具	功能
---	---
get_derelict_vessels	根据已发布的机构数据集报告废弃船只，并提供来源和可用性。没有报告并不能证明环境安全。
get_hazards	提供活跃的 NWS 海洋／沿海警报（小型船只、离岸流、巨浪、特殊海洋警报、水龙卷……），以及某个地点或经纬度的水域风险：离岸流风险、赤潮（FWC 采样）、细菌（FDOH）、马尾藻、水体清澈度、王潮、距湾流距离、闪电。在建议游泳、潜水或穿越入海口前使用。解读时：除非用户提供或确认了船只，否则不要提及船只。描述闪电时，应说明指定时间窗口内观测到或未检测到闪电，不得保证天气晴朗或安全。即使 freshness.stale=false，也要报告不可用或质控失败的数据源；数据新鲜不代表所有数据源都可用。模型海面高度不等于破碎浪高度。不同本地 MLLW 测站的潮位高度不能用于推断航道相对深度。高潮位不一定意味着潮流平缓。进行风筝冲浪时，使用 get_conditions 并提供 kiteStyle（freeride/waves/foil）、kiteExperience，以及由骑手提供的 kiteMinWindKt/kiteMaxWindKt。查看 kiteboarding，了解天气筛查、阵风幅度，以及明确标注为未经核实的下水点状态。切勿推断骑手的风速范围、下水点是否合法或是否有救援保障。活动键：kite、surf、skim（平地滑水）、skim-wave（乘浪滑水）、paddle（平水桨板）、sup-surf（SUP 冲浪）。没有海岸线观测时，不对 skim 适宜性评分；缺失的评分不得沿用其他活动的评分。离岸风可能有利于冲浪，同时增加桨板漂移风险。单点水深无法证明航线畅通。不得编造检测百分比、未来读数、船只所有权或应用设置说明。
get_hurricane_history	搜索 NOAA NHC HURDAT2 已完成的 26 个季节（2000–2025）的最佳路径历史，涵盖大西洋和东部／中部太平洋。包括热带气旋，不仅限于飓风。可按海盆、年份范围、名称、风暴 ID、飓风强度或有记录的登陆进行筛选。默认返回分页摘要；includeTrack=true 时返回按顺序排列的 UTC 位置、持续风速（kt）、气压（mb）、状态、特殊事件标记，以及按 NE、SE、SW、NW 排列的 34/50/64 kt 风圈半径（海里）。缺失的测量值为 null。登陆标记涵盖任何海岸线，并非仅限美国海岸线。最终定稿的回溯路径不是预报；当前 2026 年的警报请使用 get_hurricanes。仅凭历史路径无法衡量当地损失或未来风险。
get_hurricanes	提供大西洋和东部／中部太平洋的 NHC 活跃热带气旋信息。返回位置、最大持续风速（kt）、气压（mb）、移动方向（角度，指向）和速度（kt）、警报时间戳，以及官方警报／预报／风暴锥链接。保留过期／不可用状态。活跃风暴列表为空并不能排除正在发展的系统或当地风险。风暴锥不是影响范围边界。遵循当地官方警报。
get_king_tide	提供经核实地点的王潮预报。保留来源采样日期和不可用状态。卫星清澈度是相对指数，并非实测潜水能见度。
get_lightning	提供 GOES-19 GLM 闪电数据。提供 lat+lon 时：返回等级（过去 5 分钟内 clear | watch 10-25 mi | danger < 10 mi）、最近闪电的距离（mi）和时间、15 分钟内的闪电次数、解除警报时间（距 10 mi 内最后一次闪电 30 分钟后）、SPC 雷暴展望，以及过去 30 分钟的闪电情况。不提供 lat/lon 时：返回各地点的状态。数据流过期时，status 为 null，unavailableReason 说明原因（绝不会误报为“clear”）。对于具名地点的坐标，优先使用 list_spots。应说明观测时间窗口内未检测到闪电，而不是说不存在闪电。覆盖过期／不完整意味着情况未知。不要提供此结果中未包含的检测率。解读时：除非用户提供或确认了船只，否则不要提及船只。描述闪电时，应说明指定时间窗口内观测到或未检测到闪电，不得保证天气晴朗或安全。即使 freshness.stale=false，也要报告不可用或质控失败的数据源；数据新鲜不代表所有数据源都可用。模型海面高度不等于破碎浪高度。不同本地 MLLW 测站的潮位高度不能用于推断航道相对深度。高潮位不一定意味着潮流平缓。进行风筝冲浪时，使用 get_conditions 并提供 kiteStyle（freeride/waves/foil）、kiteExperience，以及由骑手提供的 kiteMinWindKt/kiteMaxWindKt。查看 kiteboarding，了解天气筛查、阵风幅度，以及明确标注为未经核实的下水点状态。切勿推断骑手的风速范围、下水点是否合法或是否有救援保障。活动键：kite、surf、skim（平地滑水）、skim-wave（乘浪滑水）、paddle（平水桨板）、sup-surf（SUP 冲浪）。没有海岸线观测时，不对 skim 适宜性评分；缺失的评分不得沿用其他活动的评分。离岸风可能有利于冲浪，同时增加桨板漂移风险。单点水深无法证明航线畅通。不得编造检测百分比、未来读数、船只所有权或应用设置说明。
get_marine_alerts	提供地点的当前和即将生效的警报，并保留开始／结束时间和来源链接。
get_navigation_notices	根据已发布的机构数据集提供美国海岸警卫队航海者地方通告，并提供来源和可用性。没有报告并不能证明环境安全。
get_park_alerts	根据已发布的机构数据集提供沿海国家公园警报和关闭信息，并提供来源和可用性。没有报告并不能证明环境安全。
get_rip_risk	提供经核实地点的离岸流风险。保留来源采样日期和不可用状态。卫星清澈度是相对指数，并非实测潜水能见度。
get_tides	提供某个地点或经纬度在接下来 days 天的预报高潮和低潮（高于 MLLW 的英尺数，NOAA CO-OPS）、逐小时潮位曲线和入海口潮流（kt，+ 涨潮／- 落潮），以及日出／日落和月相。时间采用带有东部时区偏移的 ISO 格式。解读时：除非用户提供或确认了船只，否则不要提及船只。描述闪电时，应说明指定时间窗口内观测到或未检测到闪电，不得保证天气晴朗或安全。即使 freshness.stale=false，也要报告不可用或质控失败的数据源；数据新鲜不代表所有数据源都可用。模型海面高度不等于破碎浪高度。不同本地 MLLW 测站的潮位高度不能用于推断航道相对深度。高潮位不一定意味着潮流平缓。进行风筝冲浪时，使用 get_conditions 并提供 kiteStyle（freeride/waves/foil）、kiteExperience，以及由骑手提供的 kiteMinWindKt/kiteMaxWindKt。查看 kiteboarding，了解天气筛查、阵风幅度，以及明确标注为未经核实的下水点状态。切勿推断骑手的风速范围、下水点是否合法或是否有救援保障。活动键：kite、surf、skim（平地滑水）、skim-wave（乘浪滑水）、paddle（平水桨板）、sup-surf（SUP 冲浪）。没有海岸线观测时，不对 skim 适宜性评分；缺失的评分不得沿用其他活动的评分。离岸风可能有利于冲浪，同时增加桨板漂移风险。单点水深无法证明航线畅通。不得编造检测百分比、未来读数、船只所有权或应用设置说明。
路线、深度与船只（7）
工具	功能说明
---	---
check_route_conditions	查询最多五个按顺序排列的地点 ID 的天气和海况。仅检查采样停靠点；不会创建可航行路线，也不会检查水深、桥梁、区域或停靠点之间的状况。
get_boat	从船只库中获取一条船只记录。
get_depth	查询佛罗里达州某坐标处实际的 NOAA ENC 海图水深和可选 DEM 水深，并提供海图标注的危险、航道背景及限制区域。单点检查不能证明整条路线都满足水深要求。解读：除非用户提供或确认了船只信息，否则不要提及船只。将闪电描述为指定时间窗口内观测到或未检测到的闪电，绝不能保证天气晴朗或安全。即使 freshness.stale=false，也要报告不可用或质检未通过的数据源；数据新鲜不代表每个数据源都可用。模型海面高度不等于破碎浪高度。不同本地 MLLW 潮位站的潮高不能确定航道的相对水深。高潮时不一定是潮流平缓期。风筝冲浪请使用带有 kiteStyle (freeride/waves/foil)、kiteExperience 以及骑手提供的 kiteMinWindKt/kiteMaxWindKt 的 get_conditions。查看 kiteboarding，了解天气筛查、阵风幅度以及明确标注为未经验证的下水点状态。绝不要推断骑手的风速范围、下水点的合法通行权或救援保障。活动键：kite、surf、skim（平地滑行）、skim-wave（乘浪）、paddle（平水桨板）、sup-surf（SUP 冲浪）。没有岸线观测数据时，不对 skim 适宜性评分；缺失的分数不能沿用其他活动的分数。离岸风可能有利于冲浪，同时会增加桨板漂流风险。单点水深不能证明整条路线都满足水深要求。不要编造检测百分比、未来读数、船只所有权或应用设置说明。
list_boats	列出具有已发布规格（LOA、船宽、吃水、舭角、重量、船体类型、燃油、巡航速度）及其来源的船只。向 conditions/forecast/routes 传入船只 ID，即可获取该船只专属的舒适度和吃水信息。用户的船只为 contender-21-open-2008。
list_bridges	按名称或 west,south,east,north 边界框搜索已发布的桥梁。请向相关设施核实通行和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
list_sandbars	按名称或 west,south,east,north 边界框搜索已发布的沙洲。请向相关设施核实通行和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。对于 Lake Boca Sandbar 这类有名称、用于休闲活动或评分的地点，请先使用 list_spots 获取经过验证的坐标和 ID。此搜索用于查找地点目录中没有的地点；不要重复搜索已收录的地点。
plan_route	需要免费的 Gillby 账户（通过 OAuth 登录）。根据起点/终点地点 ID 或 lat,lon，在考虑海图的前提下规划水上路线。请提供经确认的船只库 ID 或实测吃水，并可用英尺/节为单位设置 beam、airDraft、ukc、bridgeMargin 和 speed 覆盖值。沿路线几何轨迹检查海图水深和潮汐，按所提供的船宽进行采样，识别桥梁和限制区域；数据允许时检查预测的 MHW 桥梁净空，并添加沿线天气采样。不会推断已保存的船只设置。支持按顺序设置途经点，并支持硬性约束 corridor=icw。冷启动海图可能需要 110 秒。解读：除非用户提供或确认了船只信息，否则不要提及船只。将闪电描述为指定时间窗口内观测到或未检测到的闪电，绝不能保证天气晴朗或安全。即使 freshness.stale=false，也要报告不可用或质检未通过的数据源；数据新鲜不代表每个数据源都可用。模型海面高度不等于破碎浪高度。不同本地 MLLW 潮位站的潮高不能确定航道的相对水深。高潮时不一定是潮流平缓期。风筝冲浪请使用带有 kiteStyle (freeride/waves/foil)、kiteExperience 以及骑手提供的 kiteMinWindKt/kiteMaxWindKt 的 get_conditions。查看 kiteboarding，了解天气筛查、阵风幅度以及明确标注为未经验证的下水点状态。绝不要推断骑手的风速范围、下水点的合法通行权或救援保障。活动键：kite、surf、skim（平地滑行）、skim-wave（乘浪）、paddle（平水桨板）、sup-surf（SUP 冲浪）。没有岸线观测数据时，不对 skim 适宜性评分；缺失的分数不能沿用其他活动的分数。离岸风可能有利于冲浪，同时会增加桨板漂流风险。单点水深不能证明整条路线都满足水深要求。不要编造检测百分比、未来读数、船只所有权或应用设置说明。
地点和摄像头（16）

工具	功能说明
find_anchorages	按名称或西、南、东、北边界框搜索已发布的锚地。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_beaches	按名称或西、南、东、北边界框搜索已发布的海滩。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_boat_ramps	按名称或西、南、东、北边界框搜索已发布的船艇坡道。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_dive_sites	按名称或西、南、东、北边界框搜索已发布的潜水点。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_fuel_docks	按名称或西、南、东、北边界框搜索已发布的燃油码头。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_inlets	按名称或西、南、东、北边界框搜索已发布的海湾入口。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_marinas	按名称或西、南、东、北边界框搜索已发布的游艇码头。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_piers	按名称或西、南、东、北边界框搜索已发布的码头。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_reefs	按名称或西、南、东、北边界框搜索已发布的礁石。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_waterfront_dining	按名称或西、南、东、北边界框搜索已发布的滨水餐厅。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
find_wrecks	按名称或西、南、东、北边界框搜索已发布的沉船。请向相关设施核实通行情况和运营详情。桥梁数据为已发布数据，并非实时净空计算结果。
get_camera_image	获取公开摄像头的 JPEG 图像及来源时间戳元数据，供 Gillby 面板使用。通过 MCP 返回图像字节，不会发起浏览器网络请求。
get_poi	根据精确 ID 查询已发布的沿海 POI。不会刷新设施详情，也不会计算实时桥梁净空。
get_protected_areas	从已发布的机构数据集中获取海洋保护区信息，包括来源和可用性。报告为空并不能证明环境安全。
list_cams	获取某个地点或坐标附近的实时来源链接和署名信息；可能无法获取存档图像。
search_pois	搜索公开的海洋 POI。可选参数 cats 是以逗号分隔的类别列表。燃油价格和当前桥梁净空未经核实。

水质和海洋生物（19）

工具	功能
get_algae_reports	来自已发布机构数据集的藻类样本报告，包含来源和可用性。报告为空并不能证明环境安全。
get_beach_bacteria	已验证地点的海滩细菌样本。保留来源样本日期和不可用状态。卫星水体清澈度是相对指数，并非实测潜水能见度。
get_canal_discharges	来自已发布机构数据集的运河排放和淡水释放数据，包含来源和可用性。报告为空并不能证明环境安全。
get_chlorophyll	来自已发布机构数据集的卫星叶绿素和水体颜色数据，包含来源和可用性。报告为空并不能证明环境安全。
get_coastal_sensors	来自已发布机构数据集的 SECOORA 沿海传感器观测数据，包含来源和可用性。报告为空并不能证明环境安全。
get_coral_heat	来自已发布机构数据集的珊瑚热应激和白化预测，包含来源和可用性。报告为空并不能证明环境安全。
get_fish_kills	来自已发布机构数据集的鱼类死亡报告，包含来源和可用性。报告为空并不能证明环境安全。
get_florida_lakes	佛罗里达州 USGS 湖泊监测目录，包含水位（保留原始垂直基准）、实测温度和蓄水量；标明已发布机构数据集中的历史站点和过时读数，并提供来源和可用性。报告为空并不能证明环境安全。
get_florida_rivers	佛罗里达州 NOAA 河流和水位计数据，包含来自已发布机构数据集的观测读数及单独的预报摘要，并提供来源和可用性。报告为空并不能证明环境安全。
get_jellyfish_observations	来自 OBIS 和 iNaturalist 的已发布佛罗里达州水母、箱形水母和僧帽水母观测记录，包含观测日期、不确定性、观察者署名和许可信息。包含 Boca Raton/Fort Lauderdale 救生员报告的官方链接。社区记录不是实时海滩警报；没有目击记录并不能证明它们不存在。僧帽水母属于管水母。使用 bbox 缩小样本范围；limit 默认为 20（最大为 100）。鲨鱼、水母和僧帽水母记录是注明日期的已发布观测数据，不代表实时追踪、海滩警报、数量估算或游泳安全评分。保留观测日期、不确定性、署名和来源可用性。没有记录并不代表这些动物不存在。来源检查时间不是观测时间。僧帽水母属于管水母，并非真正的水母。本地救生员链接不是已收录的当前警报；请查看来源报告日期。切勿将 NOAA 的切萨皮克海海荨麻预报用于佛罗里达州。
get_lake_okeechobee	来自已发布机构数据集的 Lake Okeechobee 水位和排放数据，包含来源和可用性。报告为空并不能证明环境安全。
get_pollution_notices	来自已发布机构数据集的污染事件通知，包含来源和可用性。报告为空并不能证明环境安全。
get_red_tide	已验证地点的赤潮样本。保留来源样本日期和不可用状态。卫星水体清澈度是相对指数，并非实测潜水能见度。
get_sargassum	已验证地点的当地马尾藻风险。保留来源样本日期和不可用状态。卫星水体清澈度是相对指数，并非实测潜水能见度。
get_sargassum_outlook	来自已发布机构数据集的马尾藻研究产品可用性信息，包含来源和可用性。报告为空并不能证明环境安全。
get_shark_research	已发布的佛罗里达州鲨鱼研究记录，包含观测日期、位置不确定性、来源署名和许可信息。包括历史声学探测和标签释放记录，不代表实时鲨鱼追踪或海滩警报。没有记录并不代表鲨鱼不存在。使用 bbox 缩小已发布样本范围；limit 默认为 20（最大为 100）。鲨鱼、水母和僧帽水母记录是注明日期的已发布观测数据，不代表实时追踪、海滩警报、数量估算或游泳安全评分。保留观测日期、不确定性、署名和来源可用性。没有记录并不代表这些动物不存在。来源检查时间不是观测时间。僧帽水母属于管水母，并非真正的水母。本地救生员链接不是已收录的当前警报；请查看来源报告日期。切勿将 NOAA 的切萨皮克海海荨麻预报用于佛罗里达州。
get_temperature_fronts	来自已发布机构数据集的卫星海温锋数据，包含来源和可用性。报告为空并不能证明环境安全。
get_usgs_water	来自已发布机构数据集的 USGS 流量、当地水位计水位、盐度和水温数据，包含来源和可用性。报告为空并不能证明环境安全。
get_water_clarity	已验证地点的卫星水体清澈度。保留来源样本日期和不可用状态。卫星水体清澈度是相对指数，并非实测潜水能见度。
数据集（2）

工具	功能说明
get_dataset	从 list_datasets 获取某个数据集的最新负载，其中包括鲨鱼和水母数据。这些海洋生物记录是带日期的观测结果，并非实时海滩预警；没有记录并不代表不存在。bbox 用于筛选列表中的数据集；category 用于筛选 USCG 通知（例如 bridge、hazard）；homeZone=true 将排放范围限定在 home zone；geometry=true 会包含 MPA 多边形。若数据集从未加载过，则返回 503。鲨鱼、水母和僧帽水母记录是带日期的已发布观测结果，并非实时追踪、海滩预警、数量估算或游泳安全评分。请保留观测日期、不确定性、归属信息和来源可用性。没有记录并不代表这些动物不存在。来源检查时间不是观测时间。僧帽水母属于管水母，不是真正的水母。当地救生员链接并非已摄取的当前预警；请查看来源报告日期。切勿将 NOAA 的切萨皮克海湾海荨麻预测用于佛罗里达。
list_datasets	政府数据集索引（SFWMD 排放、Lake O、USGS、CoastWatch 叶绿素 / SST 锋面、珊瑚热状况、USCG 通知、废弃船只、MPA、藻类、鱼类死亡、鲨鱼研究和水母 / 僧帽水母观测），并显示 ok/stale/unavailable 状态和最近一次成功更新时间。

你的账户（OAuth）（16）

工具	功能说明
delete_my_place	删除已保存的地点。重复删除会返回 deleted=false。需要你的 Gillby 账户和明确的账户授权。
delete_my_trip	删除已保存的行程。重复删除会返回 deleted=false。需要你的 Gillby 账户和明确的账户授权。
get_my_notification_settings	查看通知偏好设置和实际送达情况。需要你的 Gillby 账户和明确的账户授权。
get_my_place	查看一个已保存的地点。需要你的 Gillby 账户和明确的账户授权。
get_my_settings	查看已保存的船只、偏好设置和通知设置。缺失的船只测量值仍为 null。需要你的 Gillby 账户和明确的账户授权。
get_my_trip	查看一个已保存的行程。需要你的 Gillby 账户和明确的账户授权。
get_my_vessel	需要通过 OAuth 登录你的 Gillby 账户。仅读取你已保存的船只和航线净空设置。不写入任何数据，也不访问其他账户信息。
list_my_places	查看你已保存的地点和收藏项。需要你的 Gillby 账户和明确的账户授权。
list_my_trips	查看你已保存的行程。需要你的 Gillby 账户和明确的账户授权。
plan_my_route	需要通过 OAuth 登录。使用你已保存的船只吃水、空高、速度、龙骨下净空和桥梁净空余量进行实际海图航线规划。明确提供的测量值优先于已保存的值。绝不会猜测缺失的必需测量值。
save_my_place	保存地点或收藏项。请提供唯一的 requestId，并在重试同一次保存时重复使用；重复使用的 ID 若对应不同输入，则会被拒绝。需要你的 Gillby 账户和明确的账户授权。
save_my_trip	保存行程。请提供唯一的 requestId，并在重试时重复使用。保存操作不会评估航行安全性。需要你的 Gillby 账户和明确的账户授权。
update_my_notification_settings	保存通知偏好设置。托管送达仅限应用内；此操作不会在此 AI 客户端启用推送、电子邮件或通知。需要你的 Gillby 账户和明确的账户授权。
update_my_place	更新指定的已保存地点字段。需要你的 Gillby 账户和明确的账户授权。
update_my_settings	仅更新指定的船只或偏好设置字段。需要你的 Gillby 账户和明确的账户授权。
update_my_trip	更新指定的行程字段；此操作不会重新检查航线安全性。需要你的 Gillby 账户和明确的账户授权。

其他（3）

工具	功能
get_fishing_heatmap	已发布的佛罗里达 mahi、蓝枪鱼／白枪鱼、海鲢和 snook 证据：带日期的 NOAA 商业捕捞记录及研究／社区目击记录、来源／许可证署名、坐标不确定性、季节性记录数量，以及可配置的 0.25／0.10／0.05／0.02／0.01／0.005 度热力图网格。历史记录不代表鱼类的实时位置、迁徙轨迹、丰度、捕获率或捕获概率。采样／捕捞力度未经校正；没有记录并不能证明鱼类不存在。from/to 是包含首尾日期的 YYYY-MM-DD 观测日期；month 汇总所有选定年份。来源核查时间不等于观测时间。近期加权默认为 recent：根据观测日期而非来源检索日期，按 365 天半衰期进行指数加权。weighting=historical 表示权重相等。调用工具时不会下载上游数据。保留物种、观测日期、来源署名、坐标不确定性、查询覆盖范围、部分／过期标记以及捕捞力度偏差。热力图颜色表示记录密度，绝不表示鱼类丰度或捕获概率。商业捕捞记录与目击记录必须保持可区分。不得生成迁徙路径。
get_fishing_insights	已发布的佛罗里达 mahi、蓝枪鱼／白枪鱼、海鲢和 snook 证据：带日期的 NOAA 商业捕捞记录及研究／社区目击记录、来源／许可证署名、坐标不确定性、季节性记录数量，以及可配置的 0.25／0.10／0.05／0.02／0.01／0.005 度热力图网格。历史记录不代表鱼类的实时位置、迁徙轨迹、丰度、捕获率或捕获概率。采样／捕捞力度未经校正；没有记录并不能证明鱼类不存在。from/to 是包含首尾日期的 YYYY-MM-DD 观测日期；month 汇总所有选定年份。来源核查时间不等于观测时间。近期加权默认为 recent：根据观测日期而非来源检索日期，按 365 天半衰期进行指数加权。weighting=historical 表示权重相等。调用工具时不会下载上游数据。保留物种、观测日期、来源署名、坐标不确定性、查询覆盖范围、部分／过期标记以及捕捞力度偏差。热力图颜色表示记录密度，绝不表示鱼类丰度或捕获概率。商业捕捞记录与目击记录必须保持可区分。不得生成迁徙路径。
get_fishing_records	已发布的佛罗里达 mahi、蓝枪鱼／白枪鱼、海鲢和 snook 证据：带日期的 NOAA 商业捕捞记录及研究／社区目击记录、来源／许可证署名、坐标不确定性、季节性记录数量，以及可配置的 0.25／0.10／0.05／0.02／0.01／0.005 度热力图网格。历史记录不代表鱼类的实时位置、迁徙轨迹、丰度、捕获率或捕获概率。采样／捕捞力度未经校正；没有记录并不能证明鱼类不存在。from/to 是包含首尾日期的 YYYY-MM-DD 观测日期；month 汇总所有选定年份。来源核查时间不等于观测时间。近期加权默认为 recent：根据观测日期而非来源检索日期，按 365 天半衰期进行指数加权。weighting=historical 表示权重相等。调用工具时不会下载上游数据。保留物种、观测日期、来源署名、坐标不确定性、查询覆盖范围、部分／过期标记以及捕捞力度偏差。热力图颜色表示记录密度，绝不表示鱼类丰度或捕获概率。商业捕捞记录与目击记录必须保持可区分。不得生成迁徙路径。

## 飓风与历史路径

使用 get_hurricanes 获取 NHC 活跃气旋，使用 get_hurricane_history 获取 2000–2025 年 HURDAT2 历史数据：大西洋和东部／中部太平洋共有 973 个气旋和 27,812 条路径记录。设置 includeTrack=true，即可检索某场风暴从首次观测到最后一次观测的记录路径，包含 UTC 位置、风速、气压和登陆标记。可按海盆、季节、名称或精确风暴 ID 筛选；请求大量完整路径前，请先对摘要分页。公共数据无需登录或 API 密钥。

{"name":"get_hurricane_history","arguments":{"query":{"id":"al122005","includeTrack":true}}}

请参阅完整的飓风 API／MCP 指南、应用和实时输入架构。已最终确定的历史数据截至 2025 年；当前季节的预报使用活跃工具。路径是回溯性观测记录，不是预报或损失估算。

HTTP API

所有功能也可通过常规 HTTP GET 使用。公共端点无需密钥；账户端点、路线规划以及超过 72 小时的历史数据需要使用免费的 Gillby 账户进行 OAuth 授权。

curl --fail-with-body 'https://www.gillby.com/api/v1/conditions?spot=boca-inlet&view=summary'

• 开发者指南、示例、错误代码和版本管理：https://www.gillby.com/developers
• OpenAPI 架构：https://www.gillby.com/api/v1/openapi.json
• 适用于 AI 的文档：llms.txt 和 llms-full.txt

速率限制。 每个客户端每分钟约可发送 60 次数据请求，API 和 MCP 共用此额度。超过限制时会收到 HTTP 429 和 Retry-After；请遵循该值并降低请求频率。未提供地点的请求会返回 400 spot_required。

数据与鸣谢

数据来自 NOAA 和 NWS（预报、海洋区域、警报）、NDBC 浮标、NOAA CO-OPS 潮汐和水位数据、NOAA GOES-19 闪电数据、Open-Meteo 和 ECMWF/GFS 模型、NOAA CoastWatch、USGS、FWC、FDEP、FDOH、USCG 及其他公共来源。每个响应都会列出所用的数据来源。

Gillby 用于规划，不用于导航。请在水上活动时查阅官方海图、通告和现场状况。

许可证

本仓库中的插件、技能、Agent、评测和文档均采用 MIT 许可证。Gillby 名称和徽标、托管服务、其源代码及其返回的数据不在许可范围内；范围详情请参阅 LICENSE。更改记录列于变更日志。

---

由 Gabe Keding 构建。