@cyanheads/cdc-health-mcp-server 0.6.5 → 0.6.6
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/CLAUDE.md +18 -21
- package/README.md +3 -3
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/manifest.json +16 -5
- package/package.json +9 -6
- package/server.json +4 -4
package/CLAUDE.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Agent Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** cdc-health-statistics-mcp-server
|
|
4
|
-
**Version:** 0.6.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.
|
|
4
|
+
**Version:** 0.6.6
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.13`
|
|
6
6
|
**Engines:** Bun ≥1.3.2, Node ≥24.0.0
|
|
7
7
|
|
|
8
8
|
> **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.
|
|
@@ -80,6 +80,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
|
|
|
80
80
|
- **Use `ctx.state`** for tenant-scoped storage. Never access persistence directly.
|
|
81
81
|
- **Check `ctx.elicit` / `ctx.sample`** for presence before calling.
|
|
82
82
|
- **Secrets in env vars only** — never hardcoded.
|
|
83
|
+
- **Close the loop on issues.** When implementing work tracked by a GitHub issue, comment on the issue with what landed and close it. Do both — a comment without a close leaves stale issues open; a close without a comment leaves no record of what shipped. The comment is for future readers — state the concrete changes, not the conversation that produced them.
|
|
83
84
|
|
|
84
85
|
---
|
|
85
86
|
|
|
@@ -302,12 +303,14 @@ Available skills:
|
|
|
302
303
|
| `add-service` | Scaffold a new service integration |
|
|
303
304
|
| `add-test` | Scaffold test file for a tool, resource, or service |
|
|
304
305
|
| `field-test` | Exercise tools/resources/prompts with real inputs, verify behavior, report issues |
|
|
305
|
-
| `tool-defs-analysis` | Read-only audit of definition language across
|
|
306
|
+
| `tool-defs-analysis` | Read-only audit of MCP definition language across an existing surface — voice, leaks, defaults, recovery hints, output descriptions |
|
|
307
|
+
| `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
|
|
308
|
+
| `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
|
|
309
|
+
| `devcheck` | Lint, format, typecheck, audit |
|
|
306
310
|
| `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
|
|
307
|
-
| `
|
|
308
|
-
| `release-and-publish` |
|
|
311
|
+
| `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
|
|
312
|
+
| `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
|
|
309
313
|
| `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
|
|
310
|
-
| `migrate-mcp-ts-template` | Migrate a fork of mcp-ts-template to depend on the framework as a package |
|
|
311
314
|
| `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
|
|
312
315
|
| `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
|
|
313
316
|
| `api-auth` | Auth modes, scopes, JWT/OAuth |
|
|
@@ -334,7 +337,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
334
337
|
| `bun run rebuild` | Clean + build |
|
|
335
338
|
| `bun run clean` | Remove build artifacts |
|
|
336
339
|
| `bun run devcheck` | Lint + format + typecheck + security + changelog sync |
|
|
337
|
-
| `bun run audit:refresh` | Delete `bun.lock`, reinstall, and re-audit
|
|
340
|
+
| `bun run audit:refresh` | Delete `bun.lock`, reinstall, and re-run `bun audit`. Use when `devcheck` flags a transitive advisory — Bun's `update` is sticky on transitive resolutions, so the advisory may be a stale-lockfile false positive. If it survives the refresh, it's real. |
|
|
338
341
|
| `bun run tree` | Generate directory structure doc |
|
|
339
342
|
| `bun run format` | Auto-fix formatting |
|
|
340
343
|
| `bun run list-skills` | Print skill index from project `skills/` |
|
|
@@ -353,26 +356,17 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
353
356
|
|
|
354
357
|
**Adding an env var requires both files:** `server.json` (`environmentVariables[]`) and `manifest.json` (`mcp_config.env` + `user_config`). `lint:packaging` (wired into `devcheck`) verifies alignment.
|
|
355
358
|
|
|
359
|
+
**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`.
|
|
360
|
+
|
|
356
361
|
---
|
|
357
362
|
|
|
358
363
|
## Changelog
|
|
359
364
|
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
Each per-version file opens with YAML frontmatter:
|
|
363
|
-
|
|
364
|
-
```markdown
|
|
365
|
-
---
|
|
366
|
-
summary: "One-line headline, ≤350 chars"
|
|
367
|
-
breaking: false
|
|
368
|
-
security: false
|
|
369
|
-
---
|
|
365
|
+
This server uses a monolithic `CHANGELOG.md` (no `changelog/` directory). Edit it directly at each release. `bun run changelog:build` and the devcheck changelog-sync step skip cleanly when no `changelog/` directory is present.
|
|
370
366
|
|
|
371
|
-
|
|
372
|
-
...
|
|
373
|
-
```
|
|
367
|
+
**Section order** (Keep a Changelog): Added, Changed, Deprecated, Removed, Fixed, Security. Include only sections with entries. Open each version block with a human-readable headline.
|
|
374
368
|
|
|
375
|
-
**
|
|
369
|
+
**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` in the framework package for the full format reference.
|
|
376
370
|
|
|
377
371
|
---
|
|
378
372
|
|
|
@@ -402,4 +396,7 @@ import { getSocrataService } from '@/services/socrata/socrata-service.js';
|
|
|
402
396
|
- [ ] If wrapping external API: tests include at least one sparse payload case with omitted upstream fields
|
|
403
397
|
- [ ] Registered in `createApp()` arrays (directly or via barrel exports)
|
|
404
398
|
- [ ] Tests use `createMockContext()` from `@cyanheads/mcp-ts-core/testing`
|
|
399
|
+
- [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = package name; `interface.shortDescription` from `package.json` description
|
|
400
|
+
- [ ] `.codex-plugin/mcp.json` updated — server name key matches `package.json` name; env vars added for any required API keys
|
|
401
|
+
- [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; inline `mcpServers` entry with server name key, env vars for any required API keys
|
|
405
402
|
- [ ] `bun run devcheck` passes
|
package/README.md
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
<h1>@cyanheads/cdc-health-mcp-server</h1>
|
|
3
|
-
<p><b>
|
|
3
|
+
<p><b>Search and query CDC public health data — mortality, vaccinations, surveillance, behavioral risk (Socrata SODA API) via MCP. STDIO or Streamable HTTP.</b>
|
|
4
4
|
<div>3 Tools • 2 Resources • 1 Prompt</div>
|
|
5
5
|
</p>
|
|
6
6
|
</div>
|
|
7
7
|
|
|
8
8
|
<div align="center">
|
|
9
9
|
|
|
10
|
-
[](./CHANGELOG.md) [](./LICENSE) [](https://github.com/users/cyanheads/packages/container/package/cdc-health-mcp-server) [](https://modelcontextprotocol.io/) [](https://www.npmjs.com/package/@cyanheads/cdc-health-mcp-server) [](https://www.typescriptlang.org/) [](https://bun.sh/)
|
|
11
11
|
|
|
12
12
|
</div>
|
|
13
13
|
|
|
14
14
|
<div align="center">
|
|
15
15
|
|
|
16
|
-
[](https://github.com/cyanheads/cdc-health-mcp-server/releases/latest/download/cdc-health-mcp-server.mcpb) [](https://cursor.com/en/install-mcp?name=cdc-health-mcp-server&config=
|
|
16
|
+
[](https://github.com/cyanheads/cdc-health-mcp-server/releases/latest/download/cdc-health-mcp-server.mcpb) [](https://cursor.com/en/install-mcp?name=cdc-health-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvY2RjLWhlYWx0aC1tY3Atc2VydmVyIl19) [](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22cdc-health-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads/cdc-health-mcp-server%22%5D%7D)
|
|
17
17
|
|
|
18
18
|
[](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
|
|
19
19
|
|
package/dist/index.js
CHANGED
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,iEAAiE,CAAC;AACrG,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,SAAS,CAAC;IACd,YAAY,EAAE,kkBAAkkB;IAChlB,KAAK,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,CAAC;IACzD,SAAS,EAAE,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;IACpD,OAAO,EAAE,CAAC,kBAAkB,CAAC;IAC7B,KAAK;QACH,kBAAkB,EAAE,CAAC;IACvB,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,iEAAiE,CAAC;AACrG,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,SAAS,CAAC;IACd,YAAY,EAAE,kkBAAkkB;IAChlB,KAAK,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,CAAC;IACzD,SAAS,EAAE,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;IACpD,OAAO,EAAE,CAAC,kBAAkB,CAAC;IAC7B,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;IAC/B,KAAK;QACH,kBAAkB,EAAE,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}
|
package/manifest.json
CHANGED
|
@@ -1,9 +1,17 @@
|
|
|
1
1
|
{
|
|
2
2
|
"manifest_version": "0.3",
|
|
3
3
|
"name": "cdc-health-mcp-server",
|
|
4
|
-
"version": "0.6.
|
|
5
|
-
"description": "
|
|
6
|
-
"author": {
|
|
4
|
+
"version": "0.6.6",
|
|
5
|
+
"description": "Search and query CDC public health data — mortality, vaccinations, surveillance, behavioral risk (Socrata SODA API).",
|
|
6
|
+
"author": {
|
|
7
|
+
"name": "cyanheads"
|
|
8
|
+
},
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "https://github.com/cyanheads/cdc-health-mcp-server"
|
|
12
|
+
},
|
|
13
|
+
"homepage": "https://github.com/cyanheads/cdc-health-mcp-server#readme",
|
|
14
|
+
"license": "Apache-2.0",
|
|
7
15
|
"server": {
|
|
8
16
|
"type": "node",
|
|
9
17
|
"entry_point": "dist/index.js",
|
|
@@ -18,7 +26,9 @@
|
|
|
18
26
|
}
|
|
19
27
|
},
|
|
20
28
|
"compatibility": {
|
|
21
|
-
"runtimes": {
|
|
29
|
+
"runtimes": {
|
|
30
|
+
"node": ">=24.0.0"
|
|
31
|
+
}
|
|
22
32
|
},
|
|
23
33
|
"tools_generated": true,
|
|
24
34
|
"prompts_generated": true,
|
|
@@ -27,7 +37,8 @@
|
|
|
27
37
|
"title": "Socrata App Token",
|
|
28
38
|
"type": "string",
|
|
29
39
|
"description": "Optional app token for higher CDC Open Data rate limits.",
|
|
30
|
-
"required": false
|
|
40
|
+
"required": false,
|
|
41
|
+
"default": ""
|
|
31
42
|
},
|
|
32
43
|
"MCP_LOG_LEVEL": {
|
|
33
44
|
"title": "Log Level",
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/cdc-health-mcp-server",
|
|
3
|
-
"version": "0.6.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.6.6",
|
|
4
|
+
"description": "Search and query CDC public health data — mortality, vaccinations, surveillance, behavioral risk (Socrata SODA API) via MCP. STDIO or Streamable HTTP.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"types": "dist/index.d.ts",
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
"list-skills": "bun scripts/list-skills.ts",
|
|
31
31
|
"audit:refresh": "rm -f bun.lock && bun install && bun audit",
|
|
32
32
|
"bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/cdc-health-mcp-server.mcpb",
|
|
33
|
-
"publish-mcp": "
|
|
33
|
+
"publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
|
|
34
34
|
"changelog:build": "bun scripts/build-changelog.ts",
|
|
35
35
|
"changelog:check": "bun scripts/check-docs-sync.ts",
|
|
36
36
|
"test": "vitest run",
|
|
@@ -46,7 +46,10 @@
|
|
|
46
46
|
"public-health",
|
|
47
47
|
"socrata",
|
|
48
48
|
"health-data",
|
|
49
|
-
"typescript"
|
|
49
|
+
"typescript",
|
|
50
|
+
"bun",
|
|
51
|
+
"stdio",
|
|
52
|
+
"streamable-http"
|
|
50
53
|
],
|
|
51
54
|
"author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/cdc-health-mcp-server#readme)",
|
|
52
55
|
"funding": [
|
|
@@ -77,12 +80,12 @@
|
|
|
77
80
|
"access": "public"
|
|
78
81
|
},
|
|
79
82
|
"dependencies": {
|
|
80
|
-
"@cyanheads/mcp-ts-core": "^0.9.
|
|
83
|
+
"@cyanheads/mcp-ts-core": "^0.9.13",
|
|
81
84
|
"pino-pretty": "^13.1.3",
|
|
82
85
|
"zod": "^4.4.3"
|
|
83
86
|
},
|
|
84
87
|
"devDependencies": {
|
|
85
|
-
"@biomejs/biome": "^2.4.
|
|
88
|
+
"@biomejs/biome": "^2.4.16",
|
|
86
89
|
"@opentelemetry/api": "^1.9.1",
|
|
87
90
|
"@types/node": "^25.9.1",
|
|
88
91
|
"@vitest/coverage-istanbul": "^4.1.7",
|
package/server.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
3
|
"name": "io.github.cyanheads/cdc-health-mcp-server",
|
|
4
|
-
"description": "
|
|
4
|
+
"description": "Search and query CDC public health data — mortality, vaccinations, surveillance, behavioral risk.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"url": "https://github.com/cyanheads/cdc-health-mcp-server",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "0.6.
|
|
9
|
+
"version": "0.6.6",
|
|
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/cdc-health-mcp-server",
|
|
21
21
|
"runtimeHint": "node",
|
|
22
|
-
"version": "0.6.
|
|
22
|
+
"version": "0.6.6",
|
|
23
23
|
"packageArguments": [
|
|
24
24
|
{
|
|
25
25
|
"type": "positional",
|
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
55
55
|
"identifier": "@cyanheads/cdc-health-mcp-server",
|
|
56
56
|
"runtimeHint": "node",
|
|
57
|
-
"version": "0.6.
|
|
57
|
+
"version": "0.6.6",
|
|
58
58
|
"packageArguments": [
|
|
59
59
|
{
|
|
60
60
|
"type": "positional",
|