@cyanheads/noaa-marine-mcp-server 0.6.0 → 0.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +21 -16
- package/CLAUDE.md +21 -16
- package/Dockerfile +92 -36
- package/README.md +87 -98
- package/changelog/0.6.x/0.6.1.md +31 -0
- package/changelog/0.6.x/0.6.2.md +27 -0
- package/dist/mcp-server/resources/definitions/noaa-marine-station.resource.js +2 -2
- package/dist/mcp-server/resources/definitions/noaa-marine-station.resource.js.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-find-stations.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-find-stations.tool.js +15 -9
- package/dist/mcp-server/tools/definitions/noaa-marine-find-stations.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-conditions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-conditions.tool.js +4 -3
- package/dist/mcp-server/tools/definitions/noaa-marine-get-conditions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-current-profile.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-current-profile.tool.js +4 -3
- package/dist/mcp-server/tools/definitions/noaa-marine-get-current-profile.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-currents.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-currents.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-currents.tool.js +24 -25
- package/dist/mcp-server/tools/definitions/noaa-marine-get-currents.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-monthly-means.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-monthly-means.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-monthly-means.tool.js +12 -13
- package/dist/mcp-server/tools/definitions/noaa-marine-get-monthly-means.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-ocean-observations.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-ocean-observations.tool.js +4 -3
- package/dist/mcp-server/tools/definitions/noaa-marine-get-ocean-observations.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-tide-predictions.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-tide-predictions.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-tide-predictions.tool.js +11 -12
- package/dist/mcp-server/tools/definitions/noaa-marine-get-tide-predictions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-water-level.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-water-level.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/noaa-marine-get-water-level.tool.js +14 -15
- package/dist/mcp-server/tools/definitions/noaa-marine-get-water-level.tool.js.map +1 -1
- package/dist/services/coops/coops-service.d.ts.map +1 -1
- package/dist/services/coops/coops-service.js +12 -17
- package/dist/services/coops/coops-service.js.map +1 -1
- package/package.json +12 -11
- package/server.json +10 -24
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
|
|
8
8
|
<div align="center">
|
|
9
9
|
|
|
10
|
-
[](./CHANGELOG.md) [](./LICENSE) [](https://github.com/users/cyanheads/packages/container/package/noaa-marine-mcp-server) [](https://modelcontextprotocol.io/) [](https://www.npmjs.com/package/@cyanheads/noaa-marine-mcp-server) [](https://www.typescriptlang.org/) [](https://bun.sh/)
|
|
11
11
|
|
|
12
12
|
</div>
|
|
13
13
|
|
|
@@ -29,131 +29,96 @@
|
|
|
29
29
|
|
|
30
30
|
## Overview
|
|
31
31
|
|
|
32
|
-
US
|
|
32
|
+
US tides, currents, water levels, and buoy observations from NOAA CO-OPS and NDBC. Find coastal stations and buoys, then fetch tide and tidal-current predictions, observed and monthly-mean water levels, and live buoy conditions, current profiles, and water-column readings.
|
|
33
33
|
|
|
34
34
|
### Tools
|
|
35
35
|
|
|
36
36
|
| Tool | Description |
|
|
37
37
|
|:-----|:------------|
|
|
38
|
-
| `noaa_marine_find_stations` | Find CO-OPS tide
|
|
39
|
-
| `noaa_marine_get_tide_predictions` | High/low tide predictions or a 6-minute curve for a CO-OPS tide station
|
|
40
|
-
| `noaa_marine_get_water_level` | Observed water level at
|
|
41
|
-
| `noaa_marine_get_monthly_means` | Verified monthly tidal datums and extremes for a CO-OPS water-level station
|
|
42
|
-
| `noaa_marine_get_currents` | CO-OPS tidal
|
|
43
|
-
| `noaa_marine_get_conditions` | Live NDBC buoy conditions: waves, wind, sea-surface and air temperature, pressure
|
|
44
|
-
| `noaa_marine_get_current_profile` | Observed ocean-current depth profile from an NDBC ADCP buoy
|
|
45
|
-
| `noaa_marine_get_ocean_observations` | Sub-surface water-column
|
|
38
|
+
| `noaa_marine_find_stations` | Find CO-OPS tide, water-level, and current stations and NDBC buoys by location, name, ID, state, or capability |
|
|
39
|
+
| `noaa_marine_get_tide_predictions` | High/low tide predictions or a 6-minute curve for a CO-OPS tide station |
|
|
40
|
+
| `noaa_marine_get_water_level` | Observed water level at four cadences, paired with predictions and a storm-surge residual |
|
|
41
|
+
| `noaa_marine_get_monthly_means` | Verified monthly tidal datums and extremes for a CO-OPS water-level station |
|
|
42
|
+
| `noaa_marine_get_currents` | CO-OPS tidal-current predictions: max flood, max ebb, and slack events, or a 6-minute curve |
|
|
43
|
+
| `noaa_marine_get_conditions` | Live NDBC buoy conditions: waves, wind, sea-surface and air temperature, pressure |
|
|
44
|
+
| `noaa_marine_get_current_profile` | Observed ocean-current depth profile from an NDBC ADCP buoy |
|
|
45
|
+
| `noaa_marine_get_ocean_observations` | Sub-surface water-column readings (temperature, salinity, oxygen, and more) from an NDBC station |
|
|
46
46
|
|
|
47
47
|
### Resources
|
|
48
48
|
|
|
49
49
|
| Resource | Description |
|
|
50
50
|
|:---|:---|
|
|
51
|
-
| `noaa-marine://station/{station_id}` | Metadata for a CO-OPS or NDBC station
|
|
51
|
+
| `noaa-marine://station/{station_id}` | Metadata for a CO-OPS or NDBC station: name, coordinates, source, capabilities, prediction class, platform |
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
Everything in the resource except NDBC `owner` is also on `noaa_marine_find_stations` rows, for clients that only call tools.
|
|
54
54
|
|
|
55
55
|
## Capability reference
|
|
56
56
|
|
|
57
57
|
### `noaa_marine_find_stations` <sub>tool</sub>
|
|
58
58
|
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
- CO-OPS prediction stations also carry `prediction_class`, a third axis beside capability and platform: a tide station is `reference` (serving `hilo` and the 6-minute curve) or `subordinate` (`hilo` only, with `reference_id` naming where its offsets come from), while a current station reports its class per depth bin in `bins[]` alongside each bin's number and catalog depth in feet — the bin numbers `noaa_marine_get_currents` takes as `bin`
|
|
63
|
-
- `total_found` and `truncated` report the full match count before the limit is applied
|
|
64
|
-
- Zero matches is a success with `total_found: 0`, carrying a notice derived from the filters that were applied and an echo of the applied search
|
|
65
|
-
- A catalog that fails to load is reported as an unread source alongside the results; when every needed catalog fails, that is a typed `sources_unavailable` error rather than an empty search, whose recovery names the couple-of-minutes wait when the CO-OPS catalog was throttled
|
|
66
|
-
- Station lists are cached in-memory with a 6-hour TTL — first call after startup may be slightly slower
|
|
67
|
-
- Typed `incomplete_coordinates` error when only one of latitude/longitude is supplied
|
|
59
|
+
- Filters combine: `latitude` + `longitude` with `radius_km` (default 100, max 1000), `query` (name or ID substring on both sources; an exact ID leads unless sorting by distance), `state` (CO-OPS only), `source` (`coops` / `ndbc` / `all`), and `types` (`tide`, `current`, `water_level`, `met`, `current_profile`, `water_quality`, or the platform class `buoy`); `limit` defaults to 20, max 200
|
|
60
|
+
- Each station carries `source`, `capabilities`, `type`, and for NDBC a `platform`; CO-OPS rows add `state` (`state_derived: true` when borrowed from the nearest state-bearing station within 25 km), a tide `prediction_class` (`reference`, or `subordinate` with `reference_id`), and current `bins[]` giving each bin's number, depth in feet, and class
|
|
61
|
+
- `total_found` and `truncated` report the count before `limit`; zero matches is a success with `applied_search`, a partial catalog read is flagged in `sources`, and total catalog failure is `sources_unavailable`; only one of `latitude`/`longitude` is `incomplete_coordinates`
|
|
68
62
|
|
|
69
63
|
---
|
|
70
64
|
|
|
71
65
|
### `noaa_marine_get_tide_predictions` <sub>tool</sub>
|
|
72
66
|
|
|
73
|
-
- `hilo` (default
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
- Ten datums, matching what the CO-OPS predictions product accepts: MLLW (default, US nautical chart), MHHW, MHW, MTL, MSL, MLW, DTL, NAVD (NAVD88, where the station has a tie), STND (the station's own datum), CRD (Columbia River only)
|
|
77
|
-
- A datum the station does not carry is a typed `datum_unavailable` naming the planes it does, not a report that the station ID was wrong; a Great Lakes station, which publishes no prediction series at any datum, is `no_predictions` pointing at `noaa_marine_get_water_level`
|
|
78
|
-
- Time zone (`lst_ldt` default, `gmt`, `lst`) and units (`english` default feet, `metric` meters)
|
|
79
|
-
- Typed `date_range_exceeded`, `invalid_date_range`, `station_not_found`, `no_predictions`, `datum_unavailable`, `subordinate_no_6min`, and `upstream_throttled` errors — the last a retryable `RateLimited` for the HTTP 403 CO-OPS answers a burst of requests with, whose recovery says to wait a couple of minutes
|
|
67
|
+
- `interval` `hilo` (default) or `6min`, up to 365 days; ten datums (MLLW, MHHW, MHW, MTL, MSL, MLW, DTL, NAVD, STND, CRD), `time_zone` (`lst_ldt`, `gmt`, `lst`), and `units` (`english` feet, `metric` meters)
|
|
68
|
+
- `6min` works at reference stations only: a subordinate station fails as `subordinate_no_6min` naming its reference station, and a Great Lakes station is `no_predictions`, pointing to `noaa_marine_get_water_level`
|
|
69
|
+
- Other failures: `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `datum_unavailable` (naming the planes the station carries), and `upstream_throttled`, a retryable CO-OPS HTTP 403 that clears in a couple of minutes
|
|
80
70
|
|
|
81
71
|
---
|
|
82
72
|
|
|
83
73
|
### `noaa_marine_get_water_level` <sub>tool</sub>
|
|
84
74
|
|
|
85
|
-
- `interval`
|
|
86
|
-
- `
|
|
87
|
-
-
|
|
88
|
-
- Thirteen datums, matching what the CO-OPS water-level product accepts: MLLW (default, US nautical chart), MHHW, MHW, MTL, MSL, MLW, NAVD (NAVD88, where the station has a tie), STND (the station's own datum), IGLD and LWD (Great Lakes only), CRD (Columbia River only), LWI and HWI (lunitidal intervals)
|
|
89
|
-
- A datum the station does not carry is a typed `datum_unavailable` whose recovery names the planes that do read it — `STND`, `IGLD`, `LWD` at a Great Lakes station, `MLLW`/`STND` where an NAVD88 tie is missing — rather than sending the caller back to re-verify an ID `noaa_marine_find_stations` just returned
|
|
90
|
-
- A sensor outage leaves slots with no reading; they are dropped and counted in `gaps_dropped`, so `rows_matched` always counts only the slots that carried a value and continuous coverage across the range is only implied when that count is absent
|
|
91
|
-
- Paired tide predictions at the interval matching the observed cadence, fetched in parallel — the observed series returns either way, and `predictions_status` says whether an empty prediction series means CO-OPS has none or the fetch failed. Not fetched at all on `daily_mean`, which has no paired series
|
|
92
|
-
- `residual_summary` (max surge, max drawdown) only when both series are present, computed from the finite observed/predicted pairs across the whole matched series rather than the returned page. Each side clamps at zero, so a window that stayed above prediction reports `max_drawdown: 0` and one that stayed below reports `max_surge: 0`. Reported on `6min` and `hourly` only — observed high and low waters do not occur at the predicted extreme times, so a `high_low` join would rest on a small fraction of the events, and `daily_mean` has no paired series at all; the notice says which applies
|
|
93
|
-
- A range whose rows fit the response budget returns whole; a longer one returns the leading rows as a page, with `rows_matched`, `rows_returned`, `page_offset`, and `next_offset` on both consumption surfaces. Observations carry the `offset` and the paired predictions follow by time window, so a page's two series always describe one span even after gap rows shorten the observed one
|
|
94
|
-
- `daily_mean` is requested in local standard time whatever `time_zone` was passed — CO-OPS serves that product in LST only and silently shifts any other zone by a day
|
|
95
|
-
- Typed `date_range_exceeded`, `invalid_date_range`, `station_not_found`, `no_data`, `datum_unavailable`, `great_lakes_only` (`daily_mean` at a coastal station), `verified_data_lag`, and `upstream_throttled` errors — `verified_data_lag` for an `hourly`, `high_low`, or `daily_mean` window ending on or after the first day of the prior month, which CO-OPS may not have verified yet since it verifies the coarser products monthly for the prior month (an earlier window it answers the same way is `no_data`, since waiting cannot help it), and `upstream_throttled` for the HTTP 403 CO-OPS answers a burst of requests with (a 403 on the paired prediction fetch alone leaves `predictions_status: "unavailable"` instead, with a notice naming the wait)
|
|
75
|
+
- `interval` `6min` (default, 31 days), `hourly` or `high_low` (365 days), or `daily_mean` (3,655 days, Great Lakes only, always in LST; a coastal station is `great_lakes_only`); thirteen datums (MLLW, MHHW, MHW, MTL, MSL, MLW, NAVD, STND, IGLD, LWD, CRD, LWI, HWI)
|
|
76
|
+
- Observations carry `quality` (`p` / `v`, `6min` only), `sigma` (`6min` and `hourly`), and `type` (`H` / `HH` / `L` / `LL`, `high_low` only); slots with no reading are dropped and counted in `gaps_dropped`
|
|
77
|
+
- Paired predictions at the matching cadence (none on `daily_mean`), with `predictions_status` (`empty` / `unavailable`) explaining an empty series; `residual_summary` (`max_surge`, `max_drawdown`) covers the whole matched range, on `6min` and `hourly` only. Failures: `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `datum_unavailable`, `no_data`, `verified_data_lag` (a coarser-cadence window ending on or after the first day of the prior month, which CO-OPS may not have verified yet), and `upstream_throttled`
|
|
96
78
|
|
|
97
79
|
---
|
|
98
80
|
|
|
99
81
|
### `noaa_marine_get_monthly_means` <sub>tool</sub>
|
|
100
82
|
|
|
101
|
-
-
|
|
102
|
-
-
|
|
103
|
-
- `
|
|
104
|
-
- A range whose months fit the response budget returns whole; a longer one — decades of months — returns the leading months as a page with `rows_matched`, `rows_returned`, `page_offset`, and `next_offset`. Walk it with `offset`; an `offset` past the last month is an empty page rather than an error
|
|
105
|
-
- Typed `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `datum_unavailable`, `verified_data_lag`, `no_data`, and `upstream_throttled` errors. CO-OPS answers an unpublished window with one sentence whatever the cause, so a window ending on or after the first day of the prior month is `verified_data_lag` and any earlier one is `no_data`
|
|
106
|
-
- Returns the monthly record, not a trend — fitting one is left to the caller
|
|
83
|
+
- Up to 73,000 days per request; eleven datums (MLLW, MHHW, MHW, MTL, MSL, MLW, NAVD, STND, IGLD, LWD, CRD) in `english` feet or `metric` meters; the first and last months returned are those `begin_date` and `end_date` fall in
|
|
84
|
+
- One row per month: `highest`, `lowest`, the tidal datums (`mhhw`, `mhw`, `msl`, `mtl`, `mlw`, `mllw`, `dtl`), ranges (`gt`, `mn`, `dhq`, `dlq`), lunitidal intervals in hours (`hwi`, `lwi`), and the `inferred` code verbatim; values CO-OPS leaves blank are omitted, so a Great Lakes station carries only `highest`, `msl`, and `lowest`
|
|
85
|
+
- Failures: `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `datum_unavailable`, `upstream_throttled`, and for an empty window `verified_data_lag` when it ends on or after the first day of the prior month, `no_data` otherwise
|
|
107
86
|
|
|
108
87
|
---
|
|
109
88
|
|
|
110
89
|
### `noaa_marine_get_currents` <sub>tool</sub>
|
|
111
90
|
|
|
112
|
-
- `MAX_SLACK` (default
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
- Units `english` (knots for speed, feet for the echoed depth, default) or `metric` (cm/s for speed, meters for depth) — CO-OPS publishes metric current speed in cm/s, the unit `noaa_marine_get_current_profile` also reports
|
|
116
|
-
- `bin` selects one of a station's depth bins; omit it for the CO-OPS default, the shallowest. The bin CO-OPS answered with and its depth are echoed on every response, and a bin the station does not publish is a typed `bin_unavailable` naming the bins it does
|
|
117
|
-
- A station whose currents CO-OPS will not predict as discrete events returns an empty list plus CO-OPS's own wording in the notice, not an error
|
|
118
|
-
- Current station IDs are alphanumeric (e.g. `ACT4176`), distinct from numeric tide/water-level IDs
|
|
119
|
-
- Up to 1 year per request, with `begin_date`/`end_date` as `YYYYMMDD` or `YYYY-MM-DD`; typed `date_range_exceeded`, `invalid_date_range`, `station_not_found`, `no_predictions`, `predictions_unavailable`, `bin_unavailable`, and `upstream_throttled` (the HTTP 403 CO-OPS answers a burst of requests with) errors
|
|
91
|
+
- `interval` `MAX_SLACK` (default: max flood, max ebb, and slack events) or `6min`, up to 365 days; `bin` picks a depth bin from `bins[]` (default the shallowest); `units` `english` (knots, feet) or `metric` (cm/s, meters)
|
|
92
|
+
- Every response echoes `bin` and `depth`; rows carry a `flood` / `ebb` / `slack` `type`, a non-negative `speed`, and as `direction` the station's mean bearing for that flow
|
|
93
|
+
- A bin the station lacks is `bin_unavailable` listing the ones it has; a station CO-OPS won't predict as events returns an empty list with its statement in `notice`, and one with no published predictions is `predictions_unavailable`; also `invalid_date_range`, `date_range_exceeded`, `station_not_found`, `no_predictions`, and `upstream_throttled`
|
|
120
94
|
|
|
121
95
|
---
|
|
122
96
|
|
|
123
97
|
### `noaa_marine_get_conditions` <sub>tool</sub>
|
|
124
98
|
|
|
125
|
-
-
|
|
126
|
-
-
|
|
127
|
-
- Every sensor field is nullable — `null` when the buoy did not report, never a fabricated value. `latitude`/`longitude` are `null` for a station absent from the NDBC catalog, and `observed_at` is always a valid instant
|
|
128
|
-
- NDBC writes each block of columns on its own cycle, so a block resolves from the most recent row within 90 minutes that carried it: waves report their own `waves_observed_at`, and any other block read from an earlier row is named with its measurement time in the response notice. Row cadence runs 5–60 minutes depending on the station
|
|
129
|
-
- Typed `buoy_not_found` and `no_sensor_data` errors
|
|
99
|
+
- One NDBC `station_id`; returns wind, waves, sea-surface and air temperature, dew point, and pressure in SI units, except `tide_ft` and `visibility_nmi`
|
|
100
|
+
- Every sensor field is nullable; each column block comes from the newest row within 90 minutes that carried it, waves reporting their own `waves_observed_at` and any other older block named in `notice`. Failures: `buoy_not_found`, `no_sensor_data`
|
|
130
101
|
|
|
131
102
|
---
|
|
132
103
|
|
|
133
104
|
### `noaa_marine_get_current_profile` <sub>tool</sub>
|
|
134
105
|
|
|
135
|
-
-
|
|
136
|
-
- Observed
|
|
137
|
-
- Most NDBC stations serve no ADCP profile; use `find_stations` with `types: ["current_profile"]` to discover ones that do
|
|
138
|
-
- Direction or speed is `null` per bin when the sensor did not report that component; typed `profile_not_found` and `no_current_data` errors
|
|
106
|
+
- One NDBC `station_id`, found with `types: ["current_profile"]`; `bins[]` runs shallowest first with `depth_m`, `direction_deg` (true, flow-toward), and `speed_cm_s`, the last two null when unreported
|
|
107
|
+
- Observed ADCP measurements, not the CO-OPS predictions `noaa_marine_get_currents` returns; failures are `profile_not_found` (no ADCP file) and `no_current_data`
|
|
139
108
|
|
|
140
109
|
---
|
|
141
110
|
|
|
142
111
|
### `noaa_marine_get_ocean_observations` <sub>tool</sub>
|
|
143
112
|
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
-
- Sensor coverage is sparse — most stations report only temperature and salinity; unreported values are `null`, never a fabricated zero
|
|
147
|
-
- Find candidates with `find_stations` using `source="ndbc"` and `types: ["water_quality"]`, NDBC's own water-quality catalog flag — a strong hint, not a guarantee, so expect `observations_not_found` on a flagged station serving no `.ocean` file
|
|
113
|
+
- One NDBC `station_id`, found with `types: ["water_quality"]`, a catalog flag rather than a guarantee; `readings[]` holds one row per depth with temperature, conductivity, salinity, dissolved oxygen (% and ppm), chlorophyll, turbidity, pH, and redox potential
|
|
114
|
+
- Most stations report only temperature and salinity, and unreported values are `null`; failures are `observations_not_found` (no `.ocean` file) and `no_ocean_data`
|
|
148
115
|
|
|
149
116
|
---
|
|
150
117
|
|
|
151
118
|
### `noaa-marine://station/{station_id}` <sub>resource</sub>
|
|
152
119
|
|
|
153
|
-
-
|
|
154
|
-
- `
|
|
155
|
-
- Typed `station_not_found` when both catalogs were read and neither carries the ID, and `source_unavailable` when a catalog could not be read — a station only the unread catalog carries is never reported as nonexistent. When the unread CO-OPS catalog was throttled (HTTP 403), the recovery names the couple-of-minutes wait
|
|
156
|
-
- Cached with a 6-hour TTL (`cacheHint`)
|
|
120
|
+
- `station_id` from `noaa_marine_find_stations`; returns that tool's station record as `application/json`, plus `owner` for NDBC stations, with a 6-hour `cacheHint`
|
|
121
|
+
- `station_not_found` only when both catalogs were read; `source_unavailable` when one could not be
|
|
157
122
|
|
|
158
123
|
## Features
|
|
159
124
|
|
|
@@ -161,38 +126,57 @@ Built on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): s
|
|
|
161
126
|
|
|
162
127
|
CO-OPS / NDBC-specific:
|
|
163
128
|
|
|
164
|
-
-
|
|
165
|
-
- CO-OPS and
|
|
166
|
-
-
|
|
167
|
-
-
|
|
168
|
-
- CO-OPS
|
|
129
|
+
- CO-OPS data and metadata APIs plus the NDBC active-stations catalog and `realtime2` feeds (`.txt`, `.adcp`, `.ocean`), with station catalogs cached in memory for 6 hours; CO-OPS requests carry `application=` from `NOAA_APPLICATION_ID`
|
|
130
|
+
- Station IDs never cross sources: CO-OPS tide and water-level IDs are numeric (`9447130`), CO-OPS current IDs alphanumeric (`ACT4176`), NDBC IDs 5-character codes (`46041`)
|
|
131
|
+
- CO-OPS tools take `begin_date` / `end_date` as `YYYYMMDD` or `YYYY-MM-DD` and check the calendar and each tool's range ceiling before calling (`invalid_date_range`, `date_range_exceeded`); heights default to MLLW, and a datum the station lacks is `datum_unavailable` naming ones it carries
|
|
132
|
+
- CO-OPS verifies `hourly`, `high_low`, `daily_mean`, and monthly means once a month, for the prior month: an empty window ending on or after the first of the prior month is `verified_data_lag`, an earlier one `no_data`
|
|
133
|
+
- CO-OPS answers a burst of requests with HTTP 403 for about two minutes; the CO-OPS data tools report it as a retryable `upstream_throttled` whose recovery names the wait
|
|
169
134
|
|
|
170
135
|
Agent-friendly output:
|
|
171
136
|
|
|
172
|
-
-
|
|
173
|
-
- `
|
|
174
|
-
-
|
|
175
|
-
- Typed station `source` (`coops` | `ndbc`) plus a data-capability `type` and (NDBC only) a `platform` class — agents branch on data, not string parsing
|
|
137
|
+
- Byte-bounded paging on the four CO-OPS series tools: a range that fits returns whole, and a longer one returns a leading page with `rows_matched`, `rows_returned`, `page_offset`, and `next_offset`, walked with `offset` (`limit` shrinks a page)
|
|
138
|
+
- Missing means `null` or omitted, never fabricated: NDBC `MM` markers become `null`, blank CO-OPS values are dropped, and `quality` is left out rather than defaulted
|
|
139
|
+
- Discriminated fields: station `source` (`coops` | `ndbc`), capability `type`, NDBC `platform`, and `prediction_class`, with datum and units echoed on every CO-OPS height response, so callers branch on data, not string parsing
|
|
176
140
|
|
|
177
141
|
## Getting started
|
|
178
142
|
|
|
179
|
-
No API key required. Both NOAA CO-OPS and NDBC are open, keyless data sources.
|
|
180
|
-
|
|
181
143
|
### Public Hosted Instance
|
|
182
144
|
|
|
183
|
-
|
|
145
|
+
A public instance is available at `https://noaa-marine.caseyjhand.com/mcp`, with no installation or API key. It serves Streamable HTTP; each client takes its own config shape.
|
|
146
|
+
|
|
147
|
+
For Claude Code:
|
|
148
|
+
|
|
149
|
+
```sh
|
|
150
|
+
claude mcp add --transport http noaa-marine-mcp-server https://noaa-marine.caseyjhand.com/mcp
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
For Cline (`cline_mcp_settings.json`):
|
|
184
154
|
|
|
185
155
|
```json
|
|
186
156
|
{
|
|
187
157
|
"mcpServers": {
|
|
188
|
-
"noaa-marine": {
|
|
189
|
-
"type": "
|
|
158
|
+
"noaa-marine-mcp-server": {
|
|
159
|
+
"type": "streamableHttp",
|
|
190
160
|
"url": "https://noaa-marine.caseyjhand.com/mcp"
|
|
191
161
|
}
|
|
192
162
|
}
|
|
193
163
|
}
|
|
194
164
|
```
|
|
195
165
|
|
|
166
|
+
For Cursor (`mcp.json`):
|
|
167
|
+
|
|
168
|
+
```json
|
|
169
|
+
{
|
|
170
|
+
"mcpServers": {
|
|
171
|
+
"noaa-marine-mcp-server": {
|
|
172
|
+
"url": "https://noaa-marine.caseyjhand.com/mcp"
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Claude Desktop adds remote servers under Settings → Connectors.
|
|
179
|
+
|
|
196
180
|
### Self-Hosted / Local
|
|
197
181
|
|
|
198
182
|
Add the following to your MCP client configuration file:
|
|
@@ -200,7 +184,7 @@ Add the following to your MCP client configuration file:
|
|
|
200
184
|
```json
|
|
201
185
|
{
|
|
202
186
|
"mcpServers": {
|
|
203
|
-
"noaa-marine": {
|
|
187
|
+
"noaa-marine-mcp-server": {
|
|
204
188
|
"type": "stdio",
|
|
205
189
|
"command": "bunx",
|
|
206
190
|
"args": ["@cyanheads/noaa-marine-mcp-server@latest"],
|
|
@@ -218,7 +202,7 @@ Or with npx (no Bun required):
|
|
|
218
202
|
```json
|
|
219
203
|
{
|
|
220
204
|
"mcpServers": {
|
|
221
|
-
"noaa-marine": {
|
|
205
|
+
"noaa-marine-mcp-server": {
|
|
222
206
|
"type": "stdio",
|
|
223
207
|
"command": "npx",
|
|
224
208
|
"args": ["-y", "@cyanheads/noaa-marine-mcp-server@latest"],
|
|
@@ -236,7 +220,7 @@ Or with Docker:
|
|
|
236
220
|
```json
|
|
237
221
|
{
|
|
238
222
|
"mcpServers": {
|
|
239
|
-
"noaa-marine": {
|
|
223
|
+
"noaa-marine-mcp-server": {
|
|
240
224
|
"type": "stdio",
|
|
241
225
|
"command": "docker",
|
|
242
226
|
"args": [
|
|
@@ -259,7 +243,7 @@ MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
|
|
|
259
243
|
### Prerequisites
|
|
260
244
|
|
|
261
245
|
- [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+).
|
|
262
|
-
- No
|
|
246
|
+
- No API key: NOAA CO-OPS and NDBC are open data sources.
|
|
263
247
|
|
|
264
248
|
### Installation
|
|
265
249
|
|
|
@@ -294,12 +278,16 @@ cp .env.example .env
|
|
|
294
278
|
|:---------|:------------|:--------|
|
|
295
279
|
| `NOAA_APPLICATION_ID` | Courtesy identifier sent as `application=` on CO-OPS requests. | `noaa-marine-mcp-server` |
|
|
296
280
|
| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |
|
|
297
|
-
| `MCP_HTTP_PORT` |
|
|
298
|
-
| `
|
|
299
|
-
| `MCP_SESSION_MODE` | HTTP session mode: `
|
|
300
|
-
| `
|
|
281
|
+
| `MCP_HTTP_PORT` | HTTP server port. | `3010` |
|
|
282
|
+
| `MCP_HTTP_HOST` | HTTP bind address. | `127.0.0.1` |
|
|
283
|
+
| `MCP_SESSION_MODE` | HTTP session mode: `stateless`, `stateful`, or `auto`. | `stateless` |
|
|
284
|
+
| `MCP_AUTH_MODE` | Authentication: `none`, `jwt`, or `oauth`. | `none` |
|
|
285
|
+
| `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `warning`, `error`, etc.). | `info` |
|
|
301
286
|
| `LOGS_DIR` | Directory for log files (Node.js only). | `<project-root>/logs` |
|
|
302
|
-
| `
|
|
287
|
+
| `LOG_TOOL_FAILURE_PAYLOADS` | Log each failed tool call's arguments and result (redacted by key name only), capped by `LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES`. | `false` |
|
|
288
|
+
| `OTEL_ENABLED` | Enable [OpenTelemetry](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry). | `false` |
|
|
289
|
+
| `OTEL_EXPORTER_OTLP_ENDPOINT` | OTLP base URL; traces and metrics export to `/v1/traces` and `/v1/metrics` under it. | — |
|
|
290
|
+
| `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` | Opt-in OTLP log export endpoint; the base URL never enables it. | — |
|
|
303
291
|
|
|
304
292
|
See [`.env.example`](./.env.example) for the full list of optional overrides.
|
|
305
293
|
|
|
@@ -338,12 +326,13 @@ The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `
|
|
|
338
326
|
|
|
339
327
|
| Path | Purpose |
|
|
340
328
|
|:-----|:--------|
|
|
341
|
-
| `src/index.ts` | `createApp()` entry point
|
|
329
|
+
| `src/index.ts` | `createApp()` entry point: registers the tools and resource, initializes services. |
|
|
342
330
|
| `src/config/` | `NOAA_APPLICATION_ID` env var parsing with Zod. |
|
|
343
|
-
| `src/services/coops/` | CO-OPS
|
|
344
|
-
| `src/services/ndbc/` | NDBC
|
|
345
|
-
| `src/
|
|
346
|
-
| `src/mcp-server/
|
|
331
|
+
| `src/services/coops/` | CO-OPS client: station catalog cache, data fetch, error classification, date-range validation, row paging, state resolution. |
|
|
332
|
+
| `src/services/ndbc/` | NDBC service: active-stations XML and `realtime2` feed parsers. |
|
|
333
|
+
| `src/services/geo.ts` | Haversine distance for proximity search and state resolution. |
|
|
334
|
+
| `src/mcp-server/tools/definitions/` | Eight tool definitions (`*.tool.ts`). |
|
|
335
|
+
| `src/mcp-server/resources/definitions/` | Station metadata resource (`noaa-marine-station.resource.ts`). |
|
|
347
336
|
| `tests/` | Vitest tests mirroring `src/`. |
|
|
348
337
|
| `docs/` | Design doc and directory tree. |
|
|
349
338
|
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "Framework 0.13.14: error results carry a request ID, wrong-typed arguments such as numeric strings are repaired instead of rejected, and the Docker image installs dependencies on the build platform."
|
|
3
|
+
breaking: false
|
|
4
|
+
security: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.6.1 — 2026-10-08
|
|
8
|
+
|
|
9
|
+
## Changed
|
|
10
|
+
|
|
11
|
+
- **Error results carry a request ID.** Every tool error result has `data.requestId` and its `content[]` text closes with `(reason … · request <id>)`; resource errors carry `data.requestId` too (mcp-ts-core 0.13.10). Declared `recovery` hints are now filled by the framework rather than forwarded by each handler; the hint text callers receive is unchanged.
|
|
12
|
+
- **Arguments are repaired before validation.** An integer sent for a string field (`station_id: 46087`) is accepted since mcp-ts-core 0.13.9; a numeric string for a number (`limit: "3"`) and a lone string for an array (`types: "tide"`) since 0.13.14. A boolean sent for a string field is still rejected with `-32602` `invalid_arguments`.
|
|
13
|
+
- **`ctx.log` notifications mirrored to the client** honor `MCP_LOG_LEVEL` and mask sensitive fields (mcp-ts-core 0.13.11).
|
|
14
|
+
- **`invalid_date_range` description reworded** in `noaa_marine_get_tide_predictions`, `noaa_marine_get_water_level`, `noaa_marine_get_monthly_means`, and `noaa_marine_get_currents`; it appears in the advertised error-reason description. Prose only; no input or output constraint changed.
|
|
15
|
+
- **`server.json`** — the npm package entries drop the `run start:*` arguments and set `runtimeHint` to `npx`; the streamable-http entry sets `MCP_TRANSPORT_TYPE` to `http`.
|
|
16
|
+
- **Docker image** — dependencies install in a `deps` stage on the build platform with a per-target cross-install (mcp-ts-core 0.13.10), musl-only native packages are pruned from the image (mcp-ts-core 0.13.11), and the base images move from Bun 1.4.0 to 1.4.2. `MCP_FORCE_CONSOLE_LOGGING` is no longer set in the image.
|
|
17
|
+
- **Packaging** — the `.mcpb` bundle excludes `/.cache/`, `/coverage/`, and `/tests/`; the npm `files` list excludes `dist/*.mcpb`.
|
|
18
|
+
- **Repo config** — `.gitignore` ignores every `.env*` variant except `.env.example`, `.env.template`, and `.env.sample`, and `.dockerignore` excludes `.env*` and the MCP Registry token files from the build context; the CodeQL workflow runs per language and uploads under `/language:<language>`.
|
|
19
|
+
- **Telemetry documentation** — `.env.example` and the README document the settings: with `OTEL_ENABLED=true`, `OTEL_EXPORTER_OTLP_ENDPOINT` alone exports traces and metrics to `<base>/v1/traces` and `<base>/v1/metrics`, and no endpoint exports nothing (mcp-ts-core 0.13.7); OTLP log export via `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` and failed-call payload logging via `LOG_TOOL_FAILURE_PAYLOADS` are opt-in (mcp-ts-core 0.13.8). The README tool and capability reference is condensed to match the current tool surface, and `MCP_HTTP_HOST` is listed with its `127.0.0.1` default.
|
|
20
|
+
|
|
21
|
+
## Dependencies
|
|
22
|
+
|
|
23
|
+
- `@cyanheads/mcp-ts-core` ^0.13.6 → ^0.13.14
|
|
24
|
+
- `pino-pretty` ^13.1.3 → ^13.2.0
|
|
25
|
+
- dev: `@biomejs/biome` ^2.5.14 → ^2.5.15
|
|
26
|
+
- dev: `@socketsecurity/bun-security-scanner` ^1.1.2 → ^1.1.3
|
|
27
|
+
- dev: `@types/node` ^26.6.2 → ^26.6.4
|
|
28
|
+
- dev: `ignore` ^7.0.9 → ^7.0.12
|
|
29
|
+
- dev: `tsc-alias` ^1.9.5 → ^1.9.7
|
|
30
|
+
- dev: `vitest` ^5.0.1 → ^5.0.3
|
|
31
|
+
- `packageManager` bun@1.4.0 → bun@1.4.2
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "Marine tool responses preserve literal station names, metadata, queries, and notices in Markdown, with framework 0.13.16 and refreshed dependencies."
|
|
3
|
+
breaking: false
|
|
4
|
+
security: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.6.2 — 2026-10-25
|
|
8
|
+
|
|
9
|
+
## Changed
|
|
10
|
+
|
|
11
|
+
- **Framework error and enrichment text** now escapes Markdown syntax in `content[]`, preserving literal messages, recovery hints, and trailer values.
|
|
12
|
+
- **Maintenance tooling and guidance** refresh audit attribution, bundle exclusions, configuration references, and hosted-client connection examples.
|
|
13
|
+
|
|
14
|
+
## Fixed
|
|
15
|
+
|
|
16
|
+
- **Marine tool Markdown** preserves literal upstream station names and metadata across all eight tools, including caller queries and discovery/current notices.
|
|
17
|
+
|
|
18
|
+
## Dependencies
|
|
19
|
+
|
|
20
|
+
- `@cyanheads/mcp-ts-core` ^0.13.14 → ^0.13.16.
|
|
21
|
+
- `zod` ^4.6.5 → ^4.6.7 (GHSA-mrhx-c7xc-m3w5).
|
|
22
|
+
- `@biomejs/biome` ^2.5.15 → ^2.6.3.
|
|
23
|
+
- `@types/node` ^26.6.4 → ^26.6.5.
|
|
24
|
+
- `ignore` ^7.0.12 → ^7.0.14.
|
|
25
|
+
- `tsc-alias` ^1.9.7 → ^1.9.9.
|
|
26
|
+
- `vitest` ^5.0.3 → ^5.0.5.
|
|
27
|
+
- **Bun** 1.4.2 → 1.4.4 (`packageManager` and Docker images).
|
|
@@ -162,12 +162,12 @@ export const noaaMarineStationResource = resource('noaa-marine://station/{statio
|
|
|
162
162
|
hint: 'CO-OPS is temporarily refusing requests from this server after a burst of calls. Wait a couple of minutes before reading the station again, and space successive calls rather than sending them back to back.',
|
|
163
163
|
},
|
|
164
164
|
}
|
|
165
|
-
:
|
|
165
|
+
: {}),
|
|
166
166
|
station_id: params.station_id,
|
|
167
167
|
unread_sources: unread,
|
|
168
168
|
});
|
|
169
169
|
}
|
|
170
|
-
throw ctx.fail('station_not_found', `Station ${params.station_id} not found in CO-OPS or NDBC. Use noaa_marine_find_stations to discover valid IDs.`, {
|
|
170
|
+
throw ctx.fail('station_not_found', `Station ${params.station_id} not found in CO-OPS or NDBC. Use noaa_marine_find_stations to discover valid IDs.`, { station_id: params.station_id });
|
|
171
171
|
},
|
|
172
172
|
});
|
|
173
173
|
//# sourceMappingURL=noaa-marine-station.resource.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"noaa-marine-station.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/noaa-marine-station.resource.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"noaa-marine-station.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/noaa-marine-station.resource.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"noaa-marine-find-stations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/noaa-marine-find-stations.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"noaa-marine-find-stations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/noaa-marine-find-stations.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAkLjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqkBjC,CAAC"}
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
*/
|
|
5
5
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
6
6
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
7
|
+
import { escapeMarkdownInline } from '@cyanheads/mcp-ts-core/utils';
|
|
7
8
|
import { getCoopsService, isCoopsThrottled } from '../../../services/coops/coops-service.js';
|
|
8
9
|
import { currentPredictionClass, tidePredictionClass } from '../../../services/coops/prediction-class.js';
|
|
9
10
|
import { STATE_CODES } from '../../../services/coops/station-state.js';
|
|
@@ -262,6 +263,7 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
|
|
|
262
263
|
sources: SourceReportSchema.optional().describe('Which station catalogs were attempted, answered, and failed. Present only when a catalog fetch rejected, so a partial result set is never read as a complete one.'),
|
|
263
264
|
},
|
|
264
265
|
enrichmentTrailer: {
|
|
266
|
+
notice: { render: (value) => `> ${escapeMarkdownInline(value)}` },
|
|
265
267
|
applied_search: {
|
|
266
268
|
render: (v) => {
|
|
267
269
|
const parts = [
|
|
@@ -273,7 +275,7 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
|
|
|
273
275
|
if (v.types)
|
|
274
276
|
parts.push(`types=[${v.types.join(', ')}]`);
|
|
275
277
|
if (v.query)
|
|
276
|
-
parts.push(`query="${v.query}"`);
|
|
278
|
+
parts.push(`query="${escapeMarkdownInline(v.query)}"`);
|
|
277
279
|
if (v.center && v.radius_km !== undefined) {
|
|
278
280
|
parts.push(`within ${v.radius_km} km of ${v.center.latitude}, ${v.center.longitude}`);
|
|
279
281
|
}
|
|
@@ -307,7 +309,7 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
|
|
|
307
309
|
const { latitude: lat, longitude: lon } = input;
|
|
308
310
|
if ((lat === undefined) !== (lon === undefined)) {
|
|
309
311
|
const missing = lat === undefined ? 'latitude' : 'longitude';
|
|
310
|
-
throw ctx.fail('incomplete_coordinates', `Proximity search needs both latitude and longitude — ${missing} is missing
|
|
312
|
+
throw ctx.fail('incomplete_coordinates', `Proximity search needs both latitude and longitude — ${missing} is missing.`);
|
|
311
313
|
}
|
|
312
314
|
const center = lat !== undefined && lon !== undefined ? { lat, lon } : undefined;
|
|
313
315
|
// Blank/whitespace-only queries carry no search intent — treat them as omitted
|
|
@@ -382,7 +384,7 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
|
|
|
382
384
|
hint: 'CO-OPS is temporarily refusing requests from this server after a burst of calls. Wait a couple of minutes before searching again, and space successive calls rather than sending them back to back.',
|
|
383
385
|
},
|
|
384
386
|
}
|
|
385
|
-
:
|
|
387
|
+
: {}),
|
|
386
388
|
failed_sources: failed,
|
|
387
389
|
});
|
|
388
390
|
}
|
|
@@ -596,20 +598,24 @@ export const noaaMarineFindStations = tool('noaa_marine_find_stations', {
|
|
|
596
598
|
? ` · ${s.state}${s.state_derived ? ' (derived from the nearest state-bearing station)' : ''}`
|
|
597
599
|
: '';
|
|
598
600
|
const typeStr = s.type ? ` · **Type:** ${s.type}` : '';
|
|
599
|
-
const platformStr = s.platform ? ` · **Platform:** ${s.platform}` : '';
|
|
600
|
-
const classStr = s.prediction_class
|
|
601
|
-
|
|
601
|
+
const platformStr = s.platform ? ` · **Platform:** ${escapeMarkdownInline(s.platform)}` : '';
|
|
602
|
+
const classStr = s.prediction_class
|
|
603
|
+
? ` · **Prediction class:** ${escapeMarkdownInline(s.prediction_class)}`
|
|
604
|
+
: '';
|
|
605
|
+
lines.push(`### ${escapeMarkdownInline(s.name)} (${escapeMarkdownInline(s.station_id)})`, `**Source:** ${s.source.toUpperCase()}${typeStr}${platformStr}${classStr}${dist}${state}`, `**Coordinates:** ${s.latitude}, ${s.longitude}`, `**Capabilities:** ${s.capabilities.length > 0 ? s.capabilities.join(', ') : 'none reported'}`);
|
|
602
606
|
if (s.bins && s.bins.length > 0) {
|
|
603
607
|
const bins = s.bins.map((b) => {
|
|
604
608
|
const depth = b.depth !== null ? `${b.depth} ft` : 'depth not published';
|
|
605
|
-
const depthType = b.depth_type ? `, ${b.depth_type}` : '';
|
|
606
|
-
const binClass = b.prediction_class
|
|
609
|
+
const depthType = b.depth_type ? `, ${escapeMarkdownInline(b.depth_type)}` : '';
|
|
610
|
+
const binClass = b.prediction_class
|
|
611
|
+
? `, ${escapeMarkdownInline(b.prediction_class)}`
|
|
612
|
+
: '';
|
|
607
613
|
return `${b.bin} (${depth}${depthType}${binClass})`;
|
|
608
614
|
});
|
|
609
615
|
lines.push(`**Current bins:** ${bins.join(' · ')}`);
|
|
610
616
|
}
|
|
611
617
|
if (s.reference_id) {
|
|
612
|
-
lines.push(`**Reference station:** ${s.reference_id}`);
|
|
618
|
+
lines.push(`**Reference station:** ${escapeMarkdownInline(s.reference_id)}`);
|
|
613
619
|
}
|
|
614
620
|
lines.push('');
|
|
615
621
|
}
|