@cyanheads/noaa-spaceweather-mcp-server 0.1.12 → 0.1.13
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 +33 -19
- package/CLAUDE.md +33 -19
- package/README.md +39 -54
- package/changelog/0.1.x/0.1.13.md +30 -0
- package/changelog/template.md +7 -24
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/package.json +10 -9
- package/server.json +3 -3
package/AGENTS.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** noaa-spaceweather-mcp-server
|
|
4
|
-
**Version:** 0.1.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.
|
|
6
|
-
**Engines:** Bun ≥1.
|
|
4
|
+
**Version:** 0.1.13
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.2`
|
|
6
|
+
**Engines:** Bun ≥1.4.0, Node ≥24.0.0
|
|
7
7
|
**MCP SDK:** `@modelcontextprotocol/server` ^2.0.0 (protocol revisions 2026-07-28 and 2025-*)
|
|
8
|
-
**Zod:** ^4.4
|
|
8
|
+
**Zod:** ^4.6.4
|
|
9
9
|
|
|
10
10
|
> **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
|
|
11
11
|
|
|
@@ -92,6 +92,12 @@ export const getConditions = tool('noaa_spaceweather_get_conditions', {
|
|
|
92
92
|
|
|
93
93
|
`createApp({ instructions })` — this server sets server-level orientation for SWPC feed guidance (start with `get_conditions`, use `get_solar_wind` for Bz monitoring, feed cadences). Sent on every `initialize`; client adoption varies.
|
|
94
94
|
|
|
95
|
+
### Session posture and shutdown
|
|
96
|
+
|
|
97
|
+
`createApp({ sessionMode: 'stateless' })` declares the HTTP session posture in `src/` rather than leaving it to a deployment's `MCP_SESSION_MODE`, which still wins whenever it carries a meaningful value (an empty string and an unsubstituted `${…}` placeholder read as unset and fall through to the option). Stateless is correct here: no tool asks the caller for input mid-handler via `ctx.requestInput`, so nothing needs `require: 'stateful'`.
|
|
98
|
+
|
|
99
|
+
`createApp({ teardown })` is the `setup()` counterpart — release a watcher, socket, or non-`unref()`'d timer there. `SpaceWeatherService` is fetch-only and allocates none, so this server declares no hook.
|
|
100
|
+
|
|
95
101
|
---
|
|
96
102
|
|
|
97
103
|
## Context
|
|
@@ -114,7 +120,7 @@ Handlers receive a unified `ctx` object. Key properties:
|
|
|
114
120
|
|
|
115
121
|
Handlers throw — the framework catches, classifies, and formats.
|
|
116
122
|
|
|
117
|
-
**Recommended: typed error contract.** Declare `errors: [{ reason, code, when, recovery, retryable? }]` on `tool()` / `resource()` to receive `ctx.fail(reason, …)` typed against the reason union. TypeScript catches typos at compile time, `data.reason` is auto-populated for observability, linter enforces conformance against the handler body. `recovery` is required (≥ 5 words, lint-validated) — the single source of truth for the agent's next move. Pass `ctx.recoveryFor('reason')` as the throw's data to put it on the wire (`data.recovery.hint`, mirrored into `content[]` text); override with an explicit `{ recovery: { hint: '...' } }` when dynamic runtime context matters. Baseline codes (`InternalError`, `ServiceUnavailable`, `Timeout`, `ValidationError`, `SerializationError`) bubble freely and don't need declaring.
|
|
123
|
+
**Recommended: typed error contract.** Declare `errors: [{ reason, code, when, recovery, retryable? }]` on `tool()` / `resource()` to receive `ctx.fail(reason, …)` typed against the reason union. TypeScript catches typos at compile time, `data.reason` is auto-populated for observability, linter enforces conformance against the handler body. `recovery` is required (≥ 5 words, lint-validated) — the single source of truth for the agent's next move. Pass `ctx.recoveryFor('reason')` as the throw's data to put it on the wire (`data.recovery.hint`, mirrored into `content[]` text); override with an explicit `{ recovery: { hint: '...' } }` when dynamic runtime context matters. Baseline codes (`InternalError`, `ServiceUnavailable`, `Timeout`, `ValidationError`, `SerializationError`, `RequestCancelled`) bubble freely and don't need declaring.
|
|
118
124
|
|
|
119
125
|
```ts
|
|
120
126
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
@@ -189,9 +195,9 @@ src/
|
|
|
189
195
|
|
|
190
196
|
## Skills
|
|
191
197
|
|
|
192
|
-
Skills are modular instructions in `skills/` at the project root. Read them directly when a task matches — e.g., `skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry.
|
|
198
|
+
Skills are modular instructions in `framework-skills/` at the project root. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. The directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand these development skills to every agent that installs it. Keep `skills/` free for skills meant for those agents.
|
|
193
199
|
|
|
194
|
-
**Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
|
|
200
|
+
**Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `framework-skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
|
|
195
201
|
|
|
196
202
|
Available skills:
|
|
197
203
|
|
|
@@ -210,8 +216,9 @@ Available skills:
|
|
|
210
216
|
| `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
|
|
211
217
|
| `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
|
|
212
218
|
| `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
|
|
213
|
-
| `git-wrapup` | Land working-tree changes as a
|
|
214
|
-
| `release-
|
|
219
|
+
| `git-wrapup` | Land working-tree changes as a commit stack — version bump, changelog, verify, commit by concern, release commit on top. No tag, no push to main; opens the release PR when the project declares release PR mode |
|
|
220
|
+
| `release-pr-review` | Review pass on an open release PR — simplifier + correctness review, fixup commits autosquashed into the stack, PR body kept in sync. Release PR mode only |
|
|
221
|
+
| `release-and-publish` | Fast-forward merge (release PR mode) + tag + push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
|
|
215
222
|
| `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
|
|
216
223
|
| `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
|
|
217
224
|
| `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
|
|
@@ -220,7 +227,7 @@ Available skills:
|
|
|
220
227
|
| `api-auth` | Auth modes, scopes, JWT/OAuth |
|
|
221
228
|
| `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
|
|
222
229
|
| `api-config` | AppConfig, parseConfig, env vars |
|
|
223
|
-
| `api-context` | Context interface, logger, state,
|
|
230
|
+
| `api-context` | Context interface, RequestContext, logger, state, multi-round-trip input |
|
|
224
231
|
| `api-errors` | McpError, JsonRpcErrorCode, error patterns |
|
|
225
232
|
| `api-linter` | Definition linter rule catalog — invoked by `bun run lint:mcp` and `devcheck` |
|
|
226
233
|
| `api-mirror` | MirrorService: persistent self-refreshing local mirror (embedded SQLite + FTS5) of a bulk upstream dataset — Tier 3 opt-in |
|
|
@@ -230,7 +237,7 @@ Available skills:
|
|
|
230
237
|
| `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
|
|
231
238
|
| `api-workers` | Cloudflare Workers runtime |
|
|
232
239
|
|
|
233
|
-
**Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
|
|
240
|
+
**Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `framework-skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
|
|
234
241
|
|
|
235
242
|
When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
|
|
236
243
|
|
|
@@ -246,7 +253,8 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
246
253
|
| `bun run rebuild` | Clean + build |
|
|
247
254
|
| `bun run clean` | Remove build artifacts |
|
|
248
255
|
| `bun run devcheck` | Lint + format + typecheck + security + changelog sync |
|
|
249
|
-
| `bun run audit:
|
|
256
|
+
| `bun run audit:fix` | `bun audit fix` — upgrade vulnerable packages to the lowest safe version within existing ranges (`--dry-run` previews, `--latest` rewrites ranges). First response when `devcheck` flags a transitive advisory; then `bun update <name>`, then `bun dedupe` |
|
|
257
|
+
| `bun run audit:refresh` | Delete `bun.lock` and reinstall. Last resort after `audit:fix`, `bun update <name>`, and `bun dedupe` — re-resolves every ranged dep (the framework pin included) and rewrites the lockfile as `lockfileVersion: 2` |
|
|
250
258
|
| `bun run lint:mcp` | Run the MCP definition linter standalone (rule catalog: `api-linter` skill) |
|
|
251
259
|
| `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |
|
|
252
260
|
| `bun run list-skills` | Print the skill registry |
|
|
@@ -264,11 +272,11 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
264
272
|
|
|
265
273
|
## Bundling
|
|
266
274
|
|
|
267
|
-
`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips dependency-shipped agent docs (`
|
|
275
|
+
`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
|
|
268
276
|
|
|
269
|
-
**Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match.
|
|
277
|
+
**Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
|
|
270
278
|
|
|
271
|
-
**README install badges** (Claude Desktop `.mcpb`, Cursor, VS Code) and the `base64` / `encodeURIComponent` config-generation commands are ship-time concerns — run the `polish-docs-meta` skill, which carries the badge format, layout, and generation snippets in `skills/polish-docs-meta/references/readme.md`.
|
|
279
|
+
**README install badges** (Claude Desktop `.mcpb`, Cursor, VS Code) and the `base64` / `encodeURIComponent` config-generation commands are ship-time concerns — run the `polish-docs-meta` skill, which carries the badge format, layout, and generation snippets in `framework-skills/polish-docs-meta/references/readme.md`.
|
|
272
280
|
|
|
273
281
|
---
|
|
274
282
|
|
|
@@ -293,12 +301,18 @@ security: false # optional — true ONLY for a source
|
|
|
293
301
|
|
|
294
302
|
`agent-notes` is an optional free-form field for maintenance agents processing the release downstream. Content here won't appear in the rendered CHANGELOG — it's consumed by agents running the `maintenance` skill. Use it for adoption instructions that don't fit the human-facing sections: new files to create, fields to populate, one-time migration steps. Omit entirely when there's nothing to say.
|
|
295
303
|
|
|
296
|
-
**Section order
|
|
304
|
+
**Section order:** the Keep a Changelog sequence — Added, Changed, Deprecated, Removed, Fixed, Security — then `Dependencies` last. Include only sections with entries — don't ship empty headers.
|
|
297
305
|
|
|
298
306
|
**Tag annotations** render as GitHub Release bodies via `--notes-from-tag`. They must be structured markdown — never a flat comma-separated string. Subject omits the version number (GitHub prepends it). See `changelog/template.md` for the full format reference.
|
|
299
307
|
|
|
300
308
|
---
|
|
301
309
|
|
|
310
|
+
## Publishing
|
|
311
|
+
|
|
312
|
+
**Every release goes through a release PR, straight-through** — `git-wrapup`'s "Release PR mode", mode `straight-through`. One run: `git-wrapup` lands the commit stack on `release/<version>`, pushes it, and opens the PR (title = the release commit subject, body = the changelog entry plus a gates section); `release-and-publish` then fast-forwards `main` locally with `git merge --ff-only`, creates the tag on `main`'s tip, pushes `main` and the tag, deletes the branch, and publishes. A caller's brief may run a given release as `gated` instead — a `release-pr-review` pass on the open PR before `release-and-publish`. **Never merge through the GitHub UI or `gh pr merge`**: squash and rebase-merge are disabled in the repo settings because both rewrite the stack (rebase-merge also strips the SSH signatures), and a merge commit breaks the linear history.
|
|
313
|
+
|
|
314
|
+
---
|
|
315
|
+
|
|
302
316
|
## Imports
|
|
303
317
|
|
|
304
318
|
```ts
|
|
@@ -325,7 +339,7 @@ import { getMyService } from '@/services/my-domain/my-service.js';
|
|
|
325
339
|
- [ ] If wrapping external API: tests include at least one sparse payload case with omitted upstream fields
|
|
326
340
|
- [ ] Registered in `createApp()` arrays (directly or via barrel exports)
|
|
327
341
|
- [ ] Tests use `createMockContext()` from `@cyanheads/mcp-ts-core/testing`
|
|
328
|
-
- [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` =
|
|
329
|
-
- [ ] `.codex-plugin/mcp.json` updated — server name key
|
|
330
|
-
- [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; inline `mcpServers` entry
|
|
342
|
+
- [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = the unscoped repo name (never the npm scope — `lint:packaging` enforces this); `interface.shortDescription` from `package.json` description
|
|
343
|
+
- [ ] `.codex-plugin/mcp.json` updated — server name key is the unscoped repo name; every user-supplied variable (API key, contact email, instance URL) is listed in `env_vars` so Codex forwards it from the user's environment. Never write `"KEY": ""` into `env` — an empty value replaces the user's exported key and is read as unset
|
|
344
|
+
- [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `author`, `repository`, `license`, `keywords` from `package.json`; inline `mcpServers` entry keyed by the unscoped repo name. Every user-supplied variable is declared under `userConfig` (`type`, `title`, `description`; `sensitive: true` for keys and tokens; `required: true` or `default: ""`) and referenced from `env` as `"KEY": "${user_config.<option>}"` — mirror the `user_config` block in `manifest.json`. Never write `"KEY": ""` into `env`
|
|
331
345
|
- [ ] `npm run devcheck` passes
|
package/CLAUDE.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** noaa-spaceweather-mcp-server
|
|
4
|
-
**Version:** 0.1.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.
|
|
6
|
-
**Engines:** Bun ≥1.
|
|
4
|
+
**Version:** 0.1.13
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.2`
|
|
6
|
+
**Engines:** Bun ≥1.4.0, Node ≥24.0.0
|
|
7
7
|
**MCP SDK:** `@modelcontextprotocol/server` ^2.0.0 (protocol revisions 2026-07-28 and 2025-*)
|
|
8
|
-
**Zod:** ^4.4
|
|
8
|
+
**Zod:** ^4.6.4
|
|
9
9
|
|
|
10
10
|
> **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
|
|
11
11
|
|
|
@@ -92,6 +92,12 @@ export const getConditions = tool('noaa_spaceweather_get_conditions', {
|
|
|
92
92
|
|
|
93
93
|
`createApp({ instructions })` — this server sets server-level orientation for SWPC feed guidance (start with `get_conditions`, use `get_solar_wind` for Bz monitoring, feed cadences). Sent on every `initialize`; client adoption varies.
|
|
94
94
|
|
|
95
|
+
### Session posture and shutdown
|
|
96
|
+
|
|
97
|
+
`createApp({ sessionMode: 'stateless' })` declares the HTTP session posture in `src/` rather than leaving it to a deployment's `MCP_SESSION_MODE`, which still wins whenever it carries a meaningful value (an empty string and an unsubstituted `${…}` placeholder read as unset and fall through to the option). Stateless is correct here: no tool asks the caller for input mid-handler via `ctx.requestInput`, so nothing needs `require: 'stateful'`.
|
|
98
|
+
|
|
99
|
+
`createApp({ teardown })` is the `setup()` counterpart — release a watcher, socket, or non-`unref()`'d timer there. `SpaceWeatherService` is fetch-only and allocates none, so this server declares no hook.
|
|
100
|
+
|
|
95
101
|
---
|
|
96
102
|
|
|
97
103
|
## Context
|
|
@@ -114,7 +120,7 @@ Handlers receive a unified `ctx` object. Key properties:
|
|
|
114
120
|
|
|
115
121
|
Handlers throw — the framework catches, classifies, and formats.
|
|
116
122
|
|
|
117
|
-
**Recommended: typed error contract.** Declare `errors: [{ reason, code, when, recovery, retryable? }]` on `tool()` / `resource()` to receive `ctx.fail(reason, …)` typed against the reason union. TypeScript catches typos at compile time, `data.reason` is auto-populated for observability, linter enforces conformance against the handler body. `recovery` is required (≥ 5 words, lint-validated) — the single source of truth for the agent's next move. Pass `ctx.recoveryFor('reason')` as the throw's data to put it on the wire (`data.recovery.hint`, mirrored into `content[]` text); override with an explicit `{ recovery: { hint: '...' } }` when dynamic runtime context matters. Baseline codes (`InternalError`, `ServiceUnavailable`, `Timeout`, `ValidationError`, `SerializationError`) bubble freely and don't need declaring.
|
|
123
|
+
**Recommended: typed error contract.** Declare `errors: [{ reason, code, when, recovery, retryable? }]` on `tool()` / `resource()` to receive `ctx.fail(reason, …)` typed against the reason union. TypeScript catches typos at compile time, `data.reason` is auto-populated for observability, linter enforces conformance against the handler body. `recovery` is required (≥ 5 words, lint-validated) — the single source of truth for the agent's next move. Pass `ctx.recoveryFor('reason')` as the throw's data to put it on the wire (`data.recovery.hint`, mirrored into `content[]` text); override with an explicit `{ recovery: { hint: '...' } }` when dynamic runtime context matters. Baseline codes (`InternalError`, `ServiceUnavailable`, `Timeout`, `ValidationError`, `SerializationError`, `RequestCancelled`) bubble freely and don't need declaring.
|
|
118
124
|
|
|
119
125
|
```ts
|
|
120
126
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
@@ -189,9 +195,9 @@ src/
|
|
|
189
195
|
|
|
190
196
|
## Skills
|
|
191
197
|
|
|
192
|
-
Skills are modular instructions in `skills/` at the project root. Read them directly when a task matches — e.g., `skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry.
|
|
198
|
+
Skills are modular instructions in `framework-skills/` at the project root. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. The directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand these development skills to every agent that installs it. Keep `skills/` free for skills meant for those agents.
|
|
193
199
|
|
|
194
|
-
**Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
|
|
200
|
+
**Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `framework-skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
|
|
195
201
|
|
|
196
202
|
Available skills:
|
|
197
203
|
|
|
@@ -210,8 +216,9 @@ Available skills:
|
|
|
210
216
|
| `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
|
|
211
217
|
| `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
|
|
212
218
|
| `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
|
|
213
|
-
| `git-wrapup` | Land working-tree changes as a
|
|
214
|
-
| `release-
|
|
219
|
+
| `git-wrapup` | Land working-tree changes as a commit stack — version bump, changelog, verify, commit by concern, release commit on top. No tag, no push to main; opens the release PR when the project declares release PR mode |
|
|
220
|
+
| `release-pr-review` | Review pass on an open release PR — simplifier + correctness review, fixup commits autosquashed into the stack, PR body kept in sync. Release PR mode only |
|
|
221
|
+
| `release-and-publish` | Fast-forward merge (release PR mode) + tag + push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
|
|
215
222
|
| `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
|
|
216
223
|
| `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
|
|
217
224
|
| `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
|
|
@@ -220,7 +227,7 @@ Available skills:
|
|
|
220
227
|
| `api-auth` | Auth modes, scopes, JWT/OAuth |
|
|
221
228
|
| `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
|
|
222
229
|
| `api-config` | AppConfig, parseConfig, env vars |
|
|
223
|
-
| `api-context` | Context interface, logger, state,
|
|
230
|
+
| `api-context` | Context interface, RequestContext, logger, state, multi-round-trip input |
|
|
224
231
|
| `api-errors` | McpError, JsonRpcErrorCode, error patterns |
|
|
225
232
|
| `api-linter` | Definition linter rule catalog — invoked by `bun run lint:mcp` and `devcheck` |
|
|
226
233
|
| `api-mirror` | MirrorService: persistent self-refreshing local mirror (embedded SQLite + FTS5) of a bulk upstream dataset — Tier 3 opt-in |
|
|
@@ -230,7 +237,7 @@ Available skills:
|
|
|
230
237
|
| `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
|
|
231
238
|
| `api-workers` | Cloudflare Workers runtime |
|
|
232
239
|
|
|
233
|
-
**Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
|
|
240
|
+
**Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `framework-skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
|
|
234
241
|
|
|
235
242
|
When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
|
|
236
243
|
|
|
@@ -246,7 +253,8 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
246
253
|
| `bun run rebuild` | Clean + build |
|
|
247
254
|
| `bun run clean` | Remove build artifacts |
|
|
248
255
|
| `bun run devcheck` | Lint + format + typecheck + security + changelog sync |
|
|
249
|
-
| `bun run audit:
|
|
256
|
+
| `bun run audit:fix` | `bun audit fix` — upgrade vulnerable packages to the lowest safe version within existing ranges (`--dry-run` previews, `--latest` rewrites ranges). First response when `devcheck` flags a transitive advisory; then `bun update <name>`, then `bun dedupe` |
|
|
257
|
+
| `bun run audit:refresh` | Delete `bun.lock` and reinstall. Last resort after `audit:fix`, `bun update <name>`, and `bun dedupe` — re-resolves every ranged dep (the framework pin included) and rewrites the lockfile as `lockfileVersion: 2` |
|
|
250
258
|
| `bun run lint:mcp` | Run the MCP definition linter standalone (rule catalog: `api-linter` skill) |
|
|
251
259
|
| `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |
|
|
252
260
|
| `bun run list-skills` | Print the skill registry |
|
|
@@ -264,11 +272,11 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
264
272
|
|
|
265
273
|
## Bundling
|
|
266
274
|
|
|
267
|
-
`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips dependency-shipped agent docs (`
|
|
275
|
+
`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
|
|
268
276
|
|
|
269
|
-
**Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match.
|
|
277
|
+
**Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
|
|
270
278
|
|
|
271
|
-
**README install badges** (Claude Desktop `.mcpb`, Cursor, VS Code) and the `base64` / `encodeURIComponent` config-generation commands are ship-time concerns — run the `polish-docs-meta` skill, which carries the badge format, layout, and generation snippets in `skills/polish-docs-meta/references/readme.md`.
|
|
279
|
+
**README install badges** (Claude Desktop `.mcpb`, Cursor, VS Code) and the `base64` / `encodeURIComponent` config-generation commands are ship-time concerns — run the `polish-docs-meta` skill, which carries the badge format, layout, and generation snippets in `framework-skills/polish-docs-meta/references/readme.md`.
|
|
272
280
|
|
|
273
281
|
---
|
|
274
282
|
|
|
@@ -293,12 +301,18 @@ security: false # optional — true ONLY for a source
|
|
|
293
301
|
|
|
294
302
|
`agent-notes` is an optional free-form field for maintenance agents processing the release downstream. Content here won't appear in the rendered CHANGELOG — it's consumed by agents running the `maintenance` skill. Use it for adoption instructions that don't fit the human-facing sections: new files to create, fields to populate, one-time migration steps. Omit entirely when there's nothing to say.
|
|
295
303
|
|
|
296
|
-
**Section order
|
|
304
|
+
**Section order:** the Keep a Changelog sequence — Added, Changed, Deprecated, Removed, Fixed, Security — then `Dependencies` last. Include only sections with entries — don't ship empty headers.
|
|
297
305
|
|
|
298
306
|
**Tag annotations** render as GitHub Release bodies via `--notes-from-tag`. They must be structured markdown — never a flat comma-separated string. Subject omits the version number (GitHub prepends it). See `changelog/template.md` for the full format reference.
|
|
299
307
|
|
|
300
308
|
---
|
|
301
309
|
|
|
310
|
+
## Publishing
|
|
311
|
+
|
|
312
|
+
**Every release goes through a release PR, straight-through** — `git-wrapup`'s "Release PR mode", mode `straight-through`. One run: `git-wrapup` lands the commit stack on `release/<version>`, pushes it, and opens the PR (title = the release commit subject, body = the changelog entry plus a gates section); `release-and-publish` then fast-forwards `main` locally with `git merge --ff-only`, creates the tag on `main`'s tip, pushes `main` and the tag, deletes the branch, and publishes. A caller's brief may run a given release as `gated` instead — a `release-pr-review` pass on the open PR before `release-and-publish`. **Never merge through the GitHub UI or `gh pr merge`**: squash and rebase-merge are disabled in the repo settings because both rewrite the stack (rebase-merge also strips the SSH signatures), and a merge commit breaks the linear history.
|
|
313
|
+
|
|
314
|
+
---
|
|
315
|
+
|
|
302
316
|
## Imports
|
|
303
317
|
|
|
304
318
|
```ts
|
|
@@ -325,7 +339,7 @@ import { getMyService } from '@/services/my-domain/my-service.js';
|
|
|
325
339
|
- [ ] If wrapping external API: tests include at least one sparse payload case with omitted upstream fields
|
|
326
340
|
- [ ] Registered in `createApp()` arrays (directly or via barrel exports)
|
|
327
341
|
- [ ] Tests use `createMockContext()` from `@cyanheads/mcp-ts-core/testing`
|
|
328
|
-
- [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` =
|
|
329
|
-
- [ ] `.codex-plugin/mcp.json` updated — server name key
|
|
330
|
-
- [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; inline `mcpServers` entry
|
|
342
|
+
- [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = the unscoped repo name (never the npm scope — `lint:packaging` enforces this); `interface.shortDescription` from `package.json` description
|
|
343
|
+
- [ ] `.codex-plugin/mcp.json` updated — server name key is the unscoped repo name; every user-supplied variable (API key, contact email, instance URL) is listed in `env_vars` so Codex forwards it from the user's environment. Never write `"KEY": ""` into `env` — an empty value replaces the user's exported key and is read as unset
|
|
344
|
+
- [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `author`, `repository`, `license`, `keywords` from `package.json`; inline `mcpServers` entry keyed by the unscoped repo name. Every user-supplied variable is declared under `userConfig` (`type`, `title`, `description`; `sensitive: true` for keys and tokens; `required: true` or `default: ""`) and referenced from `env` as `"KEY": "${user_config.<option>}"` — mirror the `user_config` block in `manifest.json`. Never write `"KEY": ""` into `env`
|
|
331
345
|
- [ ] `npm run devcheck` passes
|
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-spaceweather-mcp-server) [](https://modelcontextprotocol.io/) [](https://www.npmjs.com/package/@cyanheads/noaa-spaceweather-mcp-server) [](https://www.typescriptlang.org/) [](https://bun.sh/)
|
|
11
11
|
|
|
12
12
|
</div>
|
|
13
13
|
|
|
@@ -27,9 +27,11 @@
|
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
30
|
-
##
|
|
30
|
+
## Overview
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
Space weather from NOAA's Space Weather Prediction Center (SWPC) — geomagnetic storm scales, Kp index, aurora forecasts, solar wind, solar activity, and active alerts. Query current conditions, aurora visibility at a coordinate, or windowed plasma and magnetic-field time series from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.
|
|
33
|
+
|
|
34
|
+
### Tools
|
|
33
35
|
|
|
34
36
|
| Tool | Description |
|
|
35
37
|
|:-----|:------------|
|
|
@@ -40,85 +42,68 @@ Six tools covering the full NOAA SWPC space weather surface — from a quick sta
|
|
|
40
42
|
| `noaa_spaceweather_get_solar_activity` | Solar flare picture: GOES X-ray flux, 3-day flare-class probabilities, active solar regions with per-region probabilities, and solar radiation storm level |
|
|
41
43
|
| `noaa_spaceweather_get_alerts` | Active SWPC alerts, watches, and warnings — structured records with product type, severity, issue time, validity window, and full message text |
|
|
42
44
|
|
|
43
|
-
|
|
45
|
+
## Capability reference
|
|
44
46
|
|
|
45
|
-
|
|
47
|
+
### `noaa_spaceweather_get_conditions` <sub>tool</sub>
|
|
46
48
|
|
|
47
|
-
-
|
|
49
|
+
- No inputs — a single call composing storm scales and current Kp into one snapshot
|
|
50
|
+
- Returns today's R/S/G storm scales plus a 3-day forecast series
|
|
48
51
|
- Current Kp with G-scale equivalent and aurora-visibility latitude guidance
|
|
49
|
-
-
|
|
50
|
-
- Data sourced from `noaa-scales.json` + `noaa-planetary-k-index.json`
|
|
52
|
+
- Data sourced from the `noaa-scales.json` + `noaa-planetary-k-index.json` feeds
|
|
51
53
|
|
|
52
54
|
---
|
|
53
55
|
|
|
54
|
-
### `noaa_spaceweather_get_kp_index`
|
|
55
|
-
|
|
56
|
-
Planetary K-index time series for geomagnetic activity tracking.
|
|
56
|
+
### `noaa_spaceweather_get_kp_index` <sub>tool</sub>
|
|
57
57
|
|
|
58
|
-
- `window_days`
|
|
59
|
-
- Each record
|
|
60
|
-
-
|
|
58
|
+
- `window_days` (1–7, default 1) bounds the observed series; the forecast series is always SWPC's full 3-day forecast
|
|
59
|
+
- Each observed/forecast record carries Kp, G-scale equivalent, G-scale label, and aurora-latitude guidance
|
|
60
|
+
- Forecast excludes the feed's embedded historical "observed" entries — only forward-looking `estimated`/`predicted` rows
|
|
61
|
+
- `observedCount` reports how many observed readings matched the window
|
|
61
62
|
|
|
62
63
|
---
|
|
63
64
|
|
|
64
|
-
### `noaa_spaceweather_get_aurora_forecast`
|
|
65
|
+
### `noaa_spaceweather_get_aurora_forecast` <sub>tool</sub>
|
|
65
66
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
- Covers both hemispheres; coordinates are geographic (WGS84)
|
|
67
|
+
- Without coordinates: global metadata only — grid point count, global peak probability, peak region
|
|
68
|
+
- With `latitude`/`longitude` (WGS84, required together): nearest 1°-grid lookup, minimum Kp needed at that latitude, and a plain-language go/no-go verdict
|
|
69
|
+
- `invalid_coordinates` error when only one of the pair is supplied
|
|
70
|
+
- OVATION model updates every ~5 minutes; forecast horizon is ~30–60 minutes ahead
|
|
71
71
|
|
|
72
72
|
---
|
|
73
73
|
|
|
74
|
-
### `noaa_spaceweather_get_solar_wind`
|
|
75
|
-
|
|
76
|
-
Real-time solar wind plasma and magnetic field from SWPC's RTSW feeds.
|
|
74
|
+
### `noaa_spaceweather_get_solar_wind` <sub>tool</sub>
|
|
77
75
|
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
- Bt (total field magnitude) and GSM vector components
|
|
76
|
+
- `window_hours` (1–168, default 3) slices client-side from a feed that carries roughly the last 24 hours at ~1-minute cadence
|
|
77
|
+
- Plasma (speed, density, temperature) and magnetic field (Bx/By/Bz/Bt GSM) returned as separate oldest-first series
|
|
78
|
+
- `bzStatus` surfaces southward Bz (the storm driver) as a plain-language field
|
|
79
|
+
- `latestFeedPlasmaTime`/`latestFeedMagTime`/`feedStalenessHours` distinguish an empty window from a stale feed
|
|
80
|
+
- Every record names its reporting spacecraft — no satellite is assumed as "the" active one
|
|
84
81
|
|
|
85
82
|
---
|
|
86
83
|
|
|
87
|
-
### `noaa_spaceweather_get_solar_activity`
|
|
84
|
+
### `noaa_spaceweather_get_solar_activity` <sub>tool</sub>
|
|
88
85
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
- Active solar regions with per-region flare and proton probabilities when `include_regions: true` (default)
|
|
94
|
-
- Solar radiation storm (S-scale) level from ≥10 MeV integral proton flux
|
|
86
|
+
- `include_regions` (default true) toggles per-region active-solar-region detail to control response size
|
|
87
|
+
- GOES X-ray flux (0.1–0.8 nm) with flare-class letter (A/B/C/M/X); recent readings cover the past hour
|
|
88
|
+
- 3-day C/M/X flare-class and proton-event probabilities, each duplicated under a legacy `*1Day` name and a date-neutral name
|
|
89
|
+
- Integral proton flux (≥10 MeV) drives the reported NOAA S-scale (0–5)
|
|
95
90
|
|
|
96
91
|
---
|
|
97
92
|
|
|
98
|
-
### `noaa_spaceweather_get_alerts`
|
|
99
|
-
|
|
100
|
-
Active SWPC alerts, watches, and warnings from the `products/alerts.json` feed.
|
|
93
|
+
### `noaa_spaceweather_get_alerts` <sub>tool</sub>
|
|
101
94
|
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
-
|
|
105
|
-
-
|
|
106
|
-
- Full raw message text preserved for downstream display
|
|
95
|
+
- `active_only` (default true) — in-force Warnings/Watches/Alerts only; cancellations and Summaries excluded
|
|
96
|
+
- `max_age_hours` (1–720, default 48) bounds how far back to look; the SWPC feed itself has no expiry
|
|
97
|
+
- Each record carries product type, NOAA scale + level (0 means "no scale stated," not zero severity), parsed validity window, and full message text
|
|
98
|
+
- `cancelled` flags a record that cancels a prior product rather than being active
|
|
107
99
|
|
|
108
100
|
---
|
|
109
101
|
|
|
110
102
|
## Features
|
|
111
103
|
|
|
112
|
-
Built on [`@cyanheads/mcp-ts-core`](https://
|
|
113
|
-
|
|
114
|
-
- Declarative tool definitions — single file per tool, framework handles registration and validation
|
|
115
|
-
- Unified error handling — handlers throw, framework catches, classifies, and formats
|
|
116
|
-
- Pluggable auth: `none`, `jwt`, `oauth`
|
|
117
|
-
- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`
|
|
118
|
-
- Structured logging with optional OpenTelemetry tracing
|
|
119
|
-
- STDIO and Streamable HTTP transports
|
|
104
|
+
Built on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): stdio and Streamable HTTP transports, pluggable auth (`none` / `jwt` / `oauth`), swappable storage (`in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`), structured logging with optional OpenTelemetry tracing.
|
|
120
105
|
|
|
121
|
-
|
|
106
|
+
SWPC-specific:
|
|
122
107
|
|
|
123
108
|
- All SWPC feeds are public and keyless — no API keys required
|
|
124
109
|
- Single `SpaceWeatherService` wraps all six NOAA SWPC JSON feeds with `fetchWithTimeout` + `withRetry`
|
|
@@ -328,7 +313,7 @@ See [`CLAUDE.md`/`AGENTS.md`](./CLAUDE.md) for development guidelines and archit
|
|
|
328
313
|
|
|
329
314
|
## Contributing
|
|
330
315
|
|
|
331
|
-
Issues
|
|
316
|
+
Issues are welcome. Run checks and tests before submitting:
|
|
332
317
|
|
|
333
318
|
```sh
|
|
334
319
|
bun run devcheck
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "adopts mcp-ts-core 0.13.2 — stateless session default, session-mode server card metadata, argument-rejection structuredContent, Bun 1.4 engines floor"
|
|
3
|
+
breaking: false
|
|
4
|
+
security: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.1.13 — 2026-09-16
|
|
8
|
+
|
|
9
|
+
## Changed
|
|
10
|
+
|
|
11
|
+
- **`sessionMode: 'stateless'` declared explicitly** in `createApp()` — with `MCP_SESSION_MODE` unset, the server now resolves `stateless` (previously the schema default `auto`, which resolves to `stateful`); an exported `MCP_SESSION_MODE` value still overrides it. The Docker image and `.env.example` already pinned `stateless`, so deployed HTTP behavior is unchanged.
|
|
12
|
+
- **Session mode published on the server card** — `/.well-known/mcp.json` carries it under `_meta` key `io.github.cyanheads.mcp-ts-core/sessionMode`.
|
|
13
|
+
- **Argument rejections now carry `structuredContent.error`** — an undeclared key, wrong type, or missing field returns `structuredContent.error` (code `-32602`, `Invalid arguments for tool …`) alongside the existing text result, `isError: true`.
|
|
14
|
+
- Server identity (name, version, description) resolves from the served package rather than the process working directory.
|
|
15
|
+
- SWPC 500/501 responses now classify as `ServiceUnavailable` rather than `InternalError`; a 500 retries, a 501 does not.
|
|
16
|
+
- An empty string or unsubstituted `${…}` placeholder in a framework `MCP_*` env var now reads as unset.
|
|
17
|
+
- `SIGTERM`/`SIGINT` exit the process explicitly — `0` once shutdown settles, `1` if the 10s ceiling fires.
|
|
18
|
+
- README restructured to an Overview section plus a per-tool capability reference; `.claude-plugin/plugin.json` gains `$schema`, author contact, and keywords; issue forms accept blank issues, link the private security-advisory form, and auto-assign `cyanheads`.
|
|
19
|
+
- Framework skill tree moved from `skills/` to `framework-skills/`, so installing this server's Claude Code or Codex plugin no longer auto-loads its development skills; paths updated across `CLAUDE.md`/`AGENTS.md`, `.mcpbignore`, `.github/CONTRIBUTING.md`, `docs/tree.md`. `## Publishing` section documents the straight-through release PR flow. 28 framework skills updated, `release-pr-review` added, `bun run audit:fix` script added.
|
|
20
|
+
|
|
21
|
+
## Dependencies
|
|
22
|
+
|
|
23
|
+
- `@cyanheads/mcp-ts-core` `^0.12.3` → `^0.13.2`
|
|
24
|
+
- `zod` `^4.4.3` → `^4.6.4`
|
|
25
|
+
- `@biomejs/biome` `^2.5.10` → `^2.5.13` (dev)
|
|
26
|
+
- `@types/node` `^26.2.0` → `^26.5.1` (dev)
|
|
27
|
+
- `ignore` `^7.0.6` → `^7.0.9` (dev)
|
|
28
|
+
- `tsc-alias` `^1.9.2` → `^1.9.5` (dev)
|
|
29
|
+
- `vitest` `^4.1.11` → `^5.0.0` (dev)
|
|
30
|
+
- Bun engines floor `>=1.3.0` → `>=1.4.0`
|
package/changelog/template.md
CHANGED
|
@@ -117,30 +117,13 @@ security: false
|
|
|
117
117
|
in that unrelated item's metadata.
|
|
118
118
|
|
|
119
119
|
TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
|
|
120
|
-
via `gh release create --notes-from-tag`.
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
Dependency bumps: ← section header
|
|
128
|
-
← blank line
|
|
129
|
-
- `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6 ← bullet
|
|
130
|
-
← blank line
|
|
131
|
-
Changed: ← only sections with entries
|
|
132
|
-
← blank line
|
|
133
|
-
- `format()` output includes `query` in text mode
|
|
134
|
-
← blank line
|
|
135
|
-
Added:
|
|
136
|
-
← blank line
|
|
137
|
-
- `manifest.json` scaffolded for MCPB bundle support
|
|
138
|
-
- Install badges (Claude Desktop, Cursor, VS Code)
|
|
139
|
-
← blank line
|
|
140
|
-
<N> tests pass; `bun run devcheck` clean. ← footer
|
|
141
|
-
|
|
142
|
-
Never a flat comma-separated string. Always structured markdown with
|
|
143
|
-
sections. The tag must scan well as a rendered GitHub Release page.
|
|
120
|
+
via `gh release create --notes-from-tag`. It is a condensed digest of this
|
|
121
|
+
entry, never a copy, and its format is owned by the `release-and-publish`
|
|
122
|
+
skill (step 4, "Create the annotated tag"): the entry's `summary:` as the
|
|
123
|
+
theme line without the version, flat headline bullets — no Keep-a-Changelog
|
|
124
|
+
section headers, no gates line — at most one deps line, issue backlinks,
|
|
125
|
+
and the changelog link last. In release-PR mode the `git-wrapup` skill
|
|
126
|
+
authors that digest as the PR body's `## Changes` and the tag copies it.
|
|
144
127
|
-->
|
|
145
128
|
|
|
146
129
|
## Added
|
package/dist/index.js
CHANGED
|
@@ -9,6 +9,7 @@ import { initSpaceWeatherService } from './services/space-weather/space-weather-
|
|
|
9
9
|
await createApp({
|
|
10
10
|
name: 'noaa-spaceweather-mcp-server',
|
|
11
11
|
title: 'noaa-spaceweather-mcp-server',
|
|
12
|
+
sessionMode: 'stateless',
|
|
12
13
|
tools: allToolDefinitions,
|
|
13
14
|
resources: [],
|
|
14
15
|
prompts: [],
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAE5F,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,8BAA8B;IACpC,KAAK,EAAE,8BAA8B;IACrC,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,YAAY,EACV,wFAAwF;QACxF,8EAA8E;QAC9E,qGAAqG;QACrG,0FAA0F;QAC1F,wEAAwE;QACxE,kFAAkF;IACpF,KAAK,CAAC,IAAI;QACR,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAE5F,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,8BAA8B;IACpC,KAAK,EAAE,8BAA8B;IACrC,WAAW,EAAE,WAAW;IACxB,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,YAAY,EACV,wFAAwF;QACxF,8EAA8E;QAC9E,qGAAqG;QACrG,0FAA0F;QAC1F,wEAAwE;QACxE,kFAAkF;IACpF,KAAK,CAAC,IAAI;QACR,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;CACF,CAAC,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/noaa-spaceweather-mcp-server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.13",
|
|
4
4
|
"mcpName": "io.github.cyanheads/noaa-spaceweather-mcp-server",
|
|
5
5
|
"description": "Query NOAA SWPC space weather: geomagnetic storm scales, Kp index, aurora forecasts, solar wind, solar activity, and alerts via MCP. STDIO or Streamable HTTP.",
|
|
6
6
|
"type": "module",
|
|
@@ -24,6 +24,7 @@
|
|
|
24
24
|
"rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
|
|
25
25
|
"clean": "bun run scripts/clean.ts",
|
|
26
26
|
"devcheck": "bun run scripts/devcheck.ts",
|
|
27
|
+
"audit:fix": "bun audit fix",
|
|
27
28
|
"audit:refresh": "rm -f bun.lock && bun install && bun audit",
|
|
28
29
|
"tree": "bun run scripts/tree.ts",
|
|
29
30
|
"list-skills": "bun run scripts/list-skills.ts",
|
|
@@ -82,25 +83,25 @@
|
|
|
82
83
|
"license": "Apache-2.0",
|
|
83
84
|
"packageManager": "bun@1.4.0",
|
|
84
85
|
"engines": {
|
|
85
|
-
"bun": ">=1.
|
|
86
|
+
"bun": ">=1.4.0",
|
|
86
87
|
"node": ">=24.0.0"
|
|
87
88
|
},
|
|
88
89
|
"publishConfig": {
|
|
89
90
|
"access": "public"
|
|
90
91
|
},
|
|
91
92
|
"dependencies": {
|
|
92
|
-
"@cyanheads/mcp-ts-core": "^0.
|
|
93
|
+
"@cyanheads/mcp-ts-core": "^0.13.2",
|
|
93
94
|
"pino-pretty": "^13.1.3",
|
|
94
|
-
"zod": "^4.4
|
|
95
|
+
"zod": "^4.6.4"
|
|
95
96
|
},
|
|
96
97
|
"devDependencies": {
|
|
97
|
-
"@biomejs/biome": "^2.5.
|
|
98
|
+
"@biomejs/biome": "^2.5.13",
|
|
98
99
|
"@socketsecurity/bun-security-scanner": "^1.1.2",
|
|
99
|
-
"@types/node": "^26.
|
|
100
|
+
"@types/node": "^26.5.1",
|
|
100
101
|
"depcheck": "^1.4.7",
|
|
101
|
-
"ignore": "^7.0.
|
|
102
|
-
"tsc-alias": "^1.9.
|
|
102
|
+
"ignore": "^7.0.9",
|
|
103
|
+
"tsc-alias": "^1.9.5",
|
|
103
104
|
"typescript": "^7.0.2",
|
|
104
|
-
"vitest": "^
|
|
105
|
+
"vitest": "^5.0.0"
|
|
105
106
|
}
|
|
106
107
|
}
|
package/server.json
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
"url": "https://github.com/cyanheads/noaa-spaceweather-mcp-server",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "0.1.
|
|
9
|
+
"version": "0.1.13",
|
|
10
10
|
"remotes": [
|
|
11
11
|
{
|
|
12
12
|
"type": "streamable-http",
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
20
20
|
"identifier": "@cyanheads/noaa-spaceweather-mcp-server",
|
|
21
21
|
"runtimeHint": "bun",
|
|
22
|
-
"version": "0.1.
|
|
22
|
+
"version": "0.1.13",
|
|
23
23
|
"packageArguments": [
|
|
24
24
|
{
|
|
25
25
|
"type": "positional",
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
49
49
|
"identifier": "@cyanheads/noaa-spaceweather-mcp-server",
|
|
50
50
|
"runtimeHint": "bun",
|
|
51
|
-
"version": "0.1.
|
|
51
|
+
"version": "0.1.13",
|
|
52
52
|
"packageArguments": [
|
|
53
53
|
{
|
|
54
54
|
"type": "positional",
|