@cyanheads/cdc-health-mcp-server 0.6.6 → 0.6.8
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/.mcpbignore +2 -0
- package/CLAUDE.md +8 -3
- package/README.md +5 -5
- package/dist/mcp-server/tools/definitions/discover-datasets.tool.d.ts +9 -7
- package/dist/mcp-server/tools/definitions/discover-datasets.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/discover-datasets.tool.js +53 -30
- package/dist/mcp-server/tools/definitions/discover-datasets.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-dataset-schema.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-dataset-schema.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/query-dataset.tool.d.ts +4 -2
- package/dist/mcp-server/tools/definitions/query-dataset.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/query-dataset.tool.js +15 -5
- package/dist/mcp-server/tools/definitions/query-dataset.tool.js.map +1 -1
- package/manifest.json +1 -1
- package/package.json +7 -5
- package/server.json +3 -3
package/.mcpbignore
CHANGED
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.8
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.21`
|
|
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.
|
|
@@ -207,6 +207,7 @@ Handlers receive a unified `ctx` object. Key properties:
|
|
|
207
207
|
| `ctx.sample` | Request LLM completion from the client. **Check for presence first:** `if (ctx.sample) { ... }` |
|
|
208
208
|
| `ctx.signal` | `AbortSignal` for cancellation. |
|
|
209
209
|
| `ctx.progress` | Task progress (present when `task: true`) — `.setTotal(n)`, `.increment()`, `.update(message)`. |
|
|
210
|
+
| `ctx.enrich` | Success-path enrichment — accumulates agent-facing context (notices, totals, query echo) onto the request. Reaches `structuredContent` + `content[]` automatically. Kind-tagged helpers: `.notice(text)`, `.total(n)`, `.echo(query)`, `.delta({ field, before, after })`. Always present; typed on `HandlerContext<R, E>` when an `enrichment` block is declared. |
|
|
210
211
|
| `ctx.requestId` | Unique request ID. |
|
|
211
212
|
| `ctx.tenantId` | Tenant ID from JWT or `'default'` for stdio. |
|
|
212
213
|
|
|
@@ -311,10 +312,12 @@ Available skills:
|
|
|
311
312
|
| `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
|
|
312
313
|
| `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
|
|
313
314
|
| `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
|
|
315
|
+
| `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
|
|
314
316
|
| `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
|
|
315
317
|
| `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
|
|
316
318
|
| `api-auth` | Auth modes, scopes, JWT/OAuth |
|
|
317
319
|
| `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
|
|
320
|
+
| `api-mirror` | MirrorService: persistent self-refreshing local SQLite mirror of a bulk upstream dataset — Tier 3, Node/Bun only |
|
|
318
321
|
| `api-config` | AppConfig, parseConfig, parseEnvConfig, env vars |
|
|
319
322
|
| `api-context` | Context interface, logger, state, progress |
|
|
320
323
|
| `api-errors` | McpError, JsonRpcErrorCode, typed error contracts, error patterns |
|
|
@@ -339,11 +342,13 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
339
342
|
| `bun run devcheck` | Lint + format + typecheck + security + changelog sync |
|
|
340
343
|
| `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. |
|
|
341
344
|
| `bun run tree` | Generate directory structure doc |
|
|
342
|
-
| `bun run format` | Auto-fix formatting |
|
|
345
|
+
| `bun run format` | Auto-fix formatting (safe rules only) |
|
|
346
|
+
| `bun run format:unsafe` | Auto-fix formatting including unsafe rules (review diff before committing) |
|
|
343
347
|
| `bun run list-skills` | Print skill index from project `skills/` |
|
|
344
348
|
| `bun run bundle` | Build and pack as `.mcpb` for one-click Claude Desktop install |
|
|
345
349
|
| `bun run changelog:build` | Regenerate `CHANGELOG.md` from `changelog/*.md` |
|
|
346
350
|
| `bun run changelog:check` | Verify `CHANGELOG.md` is in sync (used by devcheck) |
|
|
351
|
+
| `bun run release:github` | Create GitHub Release from the current tag |
|
|
347
352
|
| `bun run test` | Run tests |
|
|
348
353
|
| `bun run start:stdio` | Production mode (stdio) — `bun run rebuild && bun run start:stdio` for dev smoke-tests |
|
|
349
354
|
| `bun run start:http` | Production mode (HTTP) — `bun run rebuild && bun run start:http` for dev smoke-tests |
|
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/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
|
|
|
@@ -105,7 +105,7 @@ A public instance is available at `https://cdc.caseyjhand.com/mcp` — no instal
|
|
|
105
105
|
```json
|
|
106
106
|
{
|
|
107
107
|
"mcpServers": {
|
|
108
|
-
"cdc-health": {
|
|
108
|
+
"cdc-health-mcp-server": {
|
|
109
109
|
"type": "streamable-http",
|
|
110
110
|
"url": "https://cdc.caseyjhand.com/mcp"
|
|
111
111
|
}
|
|
@@ -120,7 +120,7 @@ Add the following to your MCP client configuration file.
|
|
|
120
120
|
```json
|
|
121
121
|
{
|
|
122
122
|
"mcpServers": {
|
|
123
|
-
"cdc-health": {
|
|
123
|
+
"cdc-health-mcp-server": {
|
|
124
124
|
"type": "stdio",
|
|
125
125
|
"command": "bunx",
|
|
126
126
|
"args": ["@cyanheads/cdc-health-mcp-server@latest"],
|
|
@@ -138,7 +138,7 @@ Or with npx (no Bun required):
|
|
|
138
138
|
```json
|
|
139
139
|
{
|
|
140
140
|
"mcpServers": {
|
|
141
|
-
"cdc-health": {
|
|
141
|
+
"cdc-health-mcp-server": {
|
|
142
142
|
"type": "stdio",
|
|
143
143
|
"command": "npx",
|
|
144
144
|
"args": ["-y", "@cyanheads/cdc-health-mcp-server@latest"],
|
|
@@ -156,7 +156,7 @@ Or with Docker:
|
|
|
156
156
|
```json
|
|
157
157
|
{
|
|
158
158
|
"mcpServers": {
|
|
159
|
-
"cdc-health": {
|
|
159
|
+
"cdc-health-mcp-server": {
|
|
160
160
|
"type": "stdio",
|
|
161
161
|
"command": "docker",
|
|
162
162
|
"args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/cdc-health-mcp-server:latest"]
|
|
@@ -22,12 +22,6 @@ export declare const discoverDatasets: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
22
22
|
updatedAt: z.ZodOptional<z.ZodString>;
|
|
23
23
|
pageViews: z.ZodOptional<z.ZodNumber>;
|
|
24
24
|
}, z.core.$strip>>;
|
|
25
|
-
totalCount: z.ZodNumber;
|
|
26
|
-
appliedFilters: z.ZodObject<{
|
|
27
|
-
query: z.ZodOptional<z.ZodString>;
|
|
28
|
-
category: z.ZodOptional<z.ZodString>;
|
|
29
|
-
tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
30
|
-
}, z.core.$strip>;
|
|
31
25
|
}, z.core.$strip>, readonly [{
|
|
32
26
|
readonly reason: "rate_limited";
|
|
33
27
|
readonly code: JsonRpcErrorCode.RateLimited;
|
|
@@ -40,5 +34,13 @@ export declare const discoverDatasets: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
40
34
|
readonly when: "Socrata catalog API returned a non-success status outside of 404/429.";
|
|
41
35
|
readonly retryable: true;
|
|
42
36
|
readonly recovery: "Retry after a brief delay; the catalog may be temporarily unavailable.";
|
|
43
|
-
}]
|
|
37
|
+
}], {
|
|
38
|
+
readonly totalCount: z.ZodNumber;
|
|
39
|
+
readonly appliedFilters: z.ZodObject<{
|
|
40
|
+
query: z.ZodOptional<z.ZodString>;
|
|
41
|
+
category: z.ZodOptional<z.ZodString>;
|
|
42
|
+
tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
43
|
+
}, z.core.$strip>;
|
|
44
|
+
readonly notice: z.ZodOptional<z.ZodString>;
|
|
45
|
+
}>;
|
|
44
46
|
//# sourceMappingURL=discover-datasets.tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"discover-datasets.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/discover-datasets.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":"discover-datasets.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/discover-datasets.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AASjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqL3B,CAAC"}
|
|
@@ -5,6 +5,11 @@
|
|
|
5
5
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
6
6
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
7
7
|
import { getSocrataService } from '../../../services/socrata/socrata-service.js';
|
|
8
|
+
const AppliedFiltersSchema = z.object({
|
|
9
|
+
query: z.string().optional().describe('Search query used.'),
|
|
10
|
+
category: z.string().optional().describe('Category filter used.'),
|
|
11
|
+
tags: z.array(z.string()).optional().describe('Tag filters used.'),
|
|
12
|
+
});
|
|
8
13
|
export const discoverDatasets = tool('cdc_discover_datasets', {
|
|
9
14
|
description: 'Search the CDC dataset catalog by keyword, category, or tag. Returns dataset IDs, names, descriptions, column lists, and update timestamps.',
|
|
10
15
|
annotations: { readOnlyHint: true },
|
|
@@ -79,55 +84,73 @@ export const discoverDatasets = tool('cdc_discover_datasets', {
|
|
|
79
84
|
})
|
|
80
85
|
.describe('A single dataset catalog entry.'))
|
|
81
86
|
.describe('Matching datasets.'),
|
|
82
|
-
totalCount: z.number().describe('Total matching datasets (for pagination).'),
|
|
83
|
-
appliedFilters: z
|
|
84
|
-
.object({
|
|
85
|
-
query: z.string().optional().describe('Search query used.'),
|
|
86
|
-
category: z.string().optional().describe('Category filter used.'),
|
|
87
|
-
tags: z.array(z.string()).optional().describe('Tag filters used.'),
|
|
88
|
-
})
|
|
89
|
-
.describe('Filters that were applied to this query; absent fields indicate no filter on that dimension.'),
|
|
90
87
|
}),
|
|
88
|
+
// Agent-facing result-set context: total for pagination, the filters as the server
|
|
89
|
+
// applied them, and a recovery notice when nothing matched. Reaches structuredContent
|
|
90
|
+
// AND content[] automatically — no format() entry needed or allowed.
|
|
91
|
+
enrichment: {
|
|
92
|
+
totalCount: z.number().describe('Total matching datasets in the catalog (for pagination).'),
|
|
93
|
+
appliedFilters: AppliedFiltersSchema.describe('Filters applied to this query; absent fields indicate no filter on that dimension.'),
|
|
94
|
+
notice: z
|
|
95
|
+
.string()
|
|
96
|
+
.optional()
|
|
97
|
+
.describe('Guidance when no datasets matched — echoes the applied filters and suggests how to broaden the search.'),
|
|
98
|
+
},
|
|
99
|
+
enrichmentTrailer: {
|
|
100
|
+
totalCount: { label: 'Total Matching' },
|
|
101
|
+
appliedFilters: {
|
|
102
|
+
render: (f) => {
|
|
103
|
+
const parts = [];
|
|
104
|
+
if (f.query)
|
|
105
|
+
parts.push(`- **Query:** "${f.query}"`);
|
|
106
|
+
if (f.category)
|
|
107
|
+
parts.push(`- **Category:** "${f.category}"`);
|
|
108
|
+
if (f.tags?.length)
|
|
109
|
+
parts.push(`- **Tags:** ${f.tags.join(', ')}`);
|
|
110
|
+
return parts.length > 0
|
|
111
|
+
? `**Applied Filters:**\n${parts.join('\n')}`
|
|
112
|
+
: '**Applied Filters:** none';
|
|
113
|
+
},
|
|
114
|
+
},
|
|
115
|
+
},
|
|
91
116
|
async handler(input, ctx) {
|
|
92
117
|
const service = getSocrataService();
|
|
93
118
|
const result = await service.discover(input, ctx.signal);
|
|
119
|
+
const appliedFilters = {
|
|
120
|
+
...(input.query ? { query: input.query } : {}),
|
|
121
|
+
...(input.category ? { category: input.category } : {}),
|
|
122
|
+
...(input.tags?.length ? { tags: input.tags } : {}),
|
|
123
|
+
};
|
|
124
|
+
ctx.enrich({ totalCount: result.totalCount, appliedFilters });
|
|
125
|
+
if (result.datasets.length === 0) {
|
|
126
|
+
const filterParts = [];
|
|
127
|
+
if (input.query)
|
|
128
|
+
filterParts.push(`query "${input.query}"`);
|
|
129
|
+
if (input.category)
|
|
130
|
+
filterParts.push(`category "${input.category}"`);
|
|
131
|
+
if (input.tags?.length)
|
|
132
|
+
filterParts.push(`tags [${input.tags.join(', ')}]`);
|
|
133
|
+
const criteria = filterParts.length > 0 ? ` for ${filterParts.join(', ')}` : '';
|
|
134
|
+
ctx.enrich.notice(`No datasets found${criteria}. Try broader search terms, different keywords, or remove category/tag filters. Browse all datasets by calling with no parameters.`);
|
|
135
|
+
}
|
|
94
136
|
ctx.log.info('Dataset discovery completed', {
|
|
95
137
|
query: input.query,
|
|
96
138
|
category: input.category,
|
|
97
139
|
resultCount: result.datasets.length,
|
|
98
140
|
totalCount: result.totalCount,
|
|
99
141
|
});
|
|
100
|
-
return {
|
|
101
|
-
...result,
|
|
102
|
-
appliedFilters: {
|
|
103
|
-
...(input.query ? { query: input.query } : {}),
|
|
104
|
-
...(input.category ? { category: input.category } : {}),
|
|
105
|
-
...(input.tags?.length ? { tags: input.tags } : {}),
|
|
106
|
-
},
|
|
107
|
-
};
|
|
142
|
+
return { datasets: result.datasets };
|
|
108
143
|
},
|
|
109
144
|
format: (result) => {
|
|
110
|
-
const filters = result.appliedFilters;
|
|
111
|
-
const filterParts = [];
|
|
112
|
-
if (filters.query)
|
|
113
|
-
filterParts.push(`query "${filters.query}"`);
|
|
114
|
-
if (filters.category)
|
|
115
|
-
filterParts.push(`category "${filters.category}"`);
|
|
116
|
-
if (filters.tags?.length)
|
|
117
|
-
filterParts.push(`tags [${filters.tags.join(', ')}]`);
|
|
118
145
|
if (result.datasets.length === 0) {
|
|
119
|
-
const criteria = filterParts.length > 0 ? ` for ${filterParts.join(', ')}` : '';
|
|
120
146
|
return [
|
|
121
147
|
{
|
|
122
148
|
type: 'text',
|
|
123
|
-
text:
|
|
149
|
+
text: 'No datasets matched the search criteria.',
|
|
124
150
|
},
|
|
125
151
|
];
|
|
126
152
|
}
|
|
127
|
-
const
|
|
128
|
-
const lines = [
|
|
129
|
-
`**${result.totalCount} datasets found** (showing ${result.datasets.length})${filterSuffix}\n`,
|
|
130
|
-
];
|
|
153
|
+
const lines = [`**${result.datasets.length} datasets returned**\n`];
|
|
131
154
|
for (const d of result.datasets) {
|
|
132
155
|
lines.push(`### ${d.name}`);
|
|
133
156
|
const views = typeof d.pageViews === 'number' ? d.pageViews.toLocaleString() : '—';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"discover-datasets.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/discover-datasets.tool.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"discover-datasets.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/discover-datasets.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC3D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACjE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACnE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,uBAAuB,EAAE;IAC5D,WAAW,EACT,6IAA6I;IAC/I,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;IAEnC,MAAM,EAAE;QACN;YACE,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,gBAAgB,CAAC,WAAW;YAClC,IAAI,EAAE,4CAA4C;YAClD,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,0DAA0D;SACrE;QACD;YACE,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;YACzC,IAAI,EAAE,uEAAuE;YAC7E,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,wEAAwE;SACnF;KACF;IAED,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,gHAAgH,CACjH;QACH,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uFAAuF,CACxF;QACH,IAAI,EAAE,CAAC;aACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;aACvC,QAAQ,EAAE;aACV,QAAQ,CAAC,4DAA4D,CAAC;QACzE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,0CAA0C,CAAC;QACvD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,IAAI,CAAC;aACT,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CAAC,8DAA8D,CAAC;KAC5E,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC;aACR,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;YAC/E,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,6FAA6F,CAC9F;YACH,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mDAAmD,CAAC;YAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC1E,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC3E,WAAW,EAAE,CAAC;iBACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,6CAA6C,CAAC;YAC1D,WAAW,EAAE,CAAC;iBACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;YACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACtF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SAC7E,CAAC;aACD,QAAQ,CAAC,iCAAiC,CAAC,CAC/C;aACA,QAAQ,CAAC,oBAAoB,CAAC;KAClC,CAAC;IAEF,mFAAmF;IACnF,sFAAsF;IACtF,qEAAqE;IACrE,UAAU,EAAE;QACV,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;QAC3F,cAAc,EAAE,oBAAoB,CAAC,QAAQ,CAC3C,oFAAoF,CACrF;QACD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,wGAAwG,CACzG;KACJ;IAED,iBAAiB,EAAE;QACjB,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE;QACvC,cAAc,EAAE;YACd,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;gBACZ,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,IAAI,CAAC,CAAC,KAAK;oBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;gBACrD,IAAI,CAAC,CAAC,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAC9D,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM;oBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACnE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;oBACrB,CAAC,CAAC,yBAAyB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC7C,CAAC,CAAC,2BAA2B,CAAC;YAClC,CAAC;SACF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,cAAc,GAAG;YACrB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;QAEF,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;QAE9D,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,WAAW,GAAa,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,KAAK;gBAAE,WAAW,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YAC5D,IAAI,KAAK,CAAC,QAAQ;gBAAE,WAAW,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrE,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM;gBAAE,WAAW,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5E,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,MAAM,CAAC,MAAM,CACf,oBAAoB,QAAQ,oIAAoI,CACjK,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE;YAC1C,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YACnC,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;QAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO;gBACL;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0CAA0C;iBACjD;aACF,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAa,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,wBAAwB,CAAC,CAAC;QAC9E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YACnF,KAAK,CAAC,IAAI,CACR,aAAa,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC,QAAQ,IAAI,GAAG,mBAAmB,CAAC,CAAC,SAAS,IAAI,GAAG,iBAAiB,KAAK,EAAE,CACtH,CAAC;YACF,IAAI,CAAC,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9E,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW;qBAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,GAAG,CAAC;qBACpE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;YACxC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}
|
|
@@ -33,5 +33,5 @@ export declare const getDatasetSchema: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
33
33
|
readonly when: "Socrata metadata API returned a non-success status outside of 404/429.";
|
|
34
34
|
readonly retryable: true;
|
|
35
35
|
readonly recovery: "Retry after a brief delay; data.cdc.gov may be temporarily unavailable.";
|
|
36
|
-
}]>;
|
|
36
|
+
}], undefined>;
|
|
37
37
|
//# sourceMappingURL=get-dataset-schema.tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-dataset-schema.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-dataset-schema.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"get-dataset-schema.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-dataset-schema.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8F3B,CAAC"}
|
|
@@ -17,7 +17,6 @@ export declare const queryDataset: import("@cyanheads/mcp-ts-core").ToolDefiniti
|
|
|
17
17
|
}, z.core.$strip>, z.ZodObject<{
|
|
18
18
|
rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
19
19
|
rowCount: z.ZodNumber;
|
|
20
|
-
query: z.ZodString;
|
|
21
20
|
}, z.core.$strip>, readonly [{
|
|
22
21
|
readonly reason: "dataset_not_found";
|
|
23
22
|
readonly code: JsonRpcErrorCode.NotFound;
|
|
@@ -50,5 +49,8 @@ export declare const queryDataset: import("@cyanheads/mcp-ts-core").ToolDefiniti
|
|
|
50
49
|
readonly when: "Socrata data API returned a non-success status outside of 404, 429, or validation errors.";
|
|
51
50
|
readonly retryable: true;
|
|
52
51
|
readonly recovery: "Retry after a brief delay; data.cdc.gov may be temporarily unavailable.";
|
|
53
|
-
}]
|
|
52
|
+
}], {
|
|
53
|
+
readonly effectiveQuery: z.ZodString;
|
|
54
|
+
readonly notice: z.ZodOptional<z.ZodString>;
|
|
55
|
+
}>;
|
|
54
56
|
//# sourceMappingURL=query-dataset.tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"query-dataset.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/query-dataset.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,eAAO,MAAM,YAAY
|
|
1
|
+
{"version":3,"file":"query-dataset.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/query-dataset.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2KvB,CAAC"}
|
|
@@ -89,17 +89,30 @@ export const queryDataset = tool('cdc_query_dataset', {
|
|
|
89
89
|
.array(z.record(z.string(), z.unknown()))
|
|
90
90
|
.describe('Result rows with requested fields. Most values are strings (including numbers/dates); geo columns return GeoJSON objects.'),
|
|
91
91
|
rowCount: z.number().describe('Number of rows returned in this response.'),
|
|
92
|
-
query: z.string().describe('Assembled SoQL query string sent to Socrata.'),
|
|
93
92
|
}),
|
|
93
|
+
// Agent-facing result-set context: the assembled SoQL query sent to Socrata (for
|
|
94
|
+
// debugging and reproducibility) and a recovery notice when nothing matched.
|
|
95
|
+
// Reaches structuredContent AND content[] automatically — no format() entry needed.
|
|
96
|
+
enrichment: {
|
|
97
|
+
effectiveQuery: z.string().describe('Assembled SoQL query string sent to the Socrata API.'),
|
|
98
|
+
notice: z
|
|
99
|
+
.string()
|
|
100
|
+
.optional()
|
|
101
|
+
.describe('Guidance when no rows matched — suggests how to verify filter values or broaden the WHERE clause.'),
|
|
102
|
+
},
|
|
94
103
|
async handler(input, ctx) {
|
|
95
104
|
const service = getSocrataService();
|
|
96
105
|
const result = await service.query(input, ctx.signal);
|
|
106
|
+
ctx.enrich({ effectiveQuery: result.query });
|
|
107
|
+
if (result.rows.length === 0) {
|
|
108
|
+
ctx.enrich.notice('No rows matched the query. Verify string values are spelled exactly as stored (check with a GROUP BY enumeration), confirm numeric/date filters match the column type from the schema, or broaden the WHERE clause.');
|
|
109
|
+
}
|
|
97
110
|
ctx.log.info('Query executed', {
|
|
98
111
|
datasetId: input.datasetId,
|
|
99
112
|
rowCount: result.rowCount,
|
|
100
113
|
query: result.query,
|
|
101
114
|
});
|
|
102
|
-
return result;
|
|
115
|
+
return { rows: result.rows, rowCount: result.rowCount };
|
|
103
116
|
},
|
|
104
117
|
format: (result) => {
|
|
105
118
|
if (!result.rows[0]) {
|
|
@@ -109,8 +122,6 @@ export const queryDataset = tool('cdc_query_dataset', {
|
|
|
109
122
|
text: [
|
|
110
123
|
'No rows matched the query.',
|
|
111
124
|
'',
|
|
112
|
-
`**Query:** \`${result.query}\``,
|
|
113
|
-
'',
|
|
114
125
|
'Suggestions:',
|
|
115
126
|
'- Verify string values are spelled exactly as stored (check with a GROUP BY enumeration)',
|
|
116
127
|
'- Check that numeric/date filters match the column type from the schema',
|
|
@@ -134,7 +145,6 @@ export const queryDataset = tool('cdc_query_dataset', {
|
|
|
134
145
|
});
|
|
135
146
|
lines.push(`| ${cells.join(' | ')} |`);
|
|
136
147
|
}
|
|
137
|
-
lines.push('', `**Query:** \`${result.query}\``);
|
|
138
148
|
return [{ type: 'text', text: lines.join('\n') }];
|
|
139
149
|
},
|
|
140
150
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"query-dataset.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/query-dataset.tool.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"query-dataset.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/query-dataset.tool.ts"],"names":[],"mappings":"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"}
|
package/manifest.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"manifest_version": "0.3",
|
|
3
3
|
"name": "cdc-health-mcp-server",
|
|
4
|
-
"version": "0.6.
|
|
4
|
+
"version": "0.6.8",
|
|
5
5
|
"description": "Search and query CDC public health data — mortality, vaccinations, surveillance, behavioral risk (Socrata SODA API).",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "cyanheads"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/cdc-health-mcp-server",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.8",
|
|
4
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",
|
|
@@ -24,7 +24,8 @@
|
|
|
24
24
|
"clean": "bun scripts/clean.ts",
|
|
25
25
|
"devcheck": "bun scripts/devcheck.ts",
|
|
26
26
|
"tree": "bun scripts/tree.ts",
|
|
27
|
-
"format": "biome check --write
|
|
27
|
+
"format": "biome check --write .",
|
|
28
|
+
"format:unsafe": "biome check --write --unsafe .",
|
|
28
29
|
"lint:mcp": "bun scripts/lint-mcp.ts",
|
|
29
30
|
"lint:packaging": "bun scripts/lint-packaging.ts",
|
|
30
31
|
"list-skills": "bun scripts/list-skills.ts",
|
|
@@ -33,6 +34,7 @@
|
|
|
33
34
|
"publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
|
|
34
35
|
"changelog:build": "bun scripts/build-changelog.ts",
|
|
35
36
|
"changelog:check": "bun scripts/check-docs-sync.ts",
|
|
37
|
+
"release:github": "bun scripts/release-github.ts",
|
|
36
38
|
"test": "vitest run",
|
|
37
39
|
"start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
|
|
38
40
|
"start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
|
|
@@ -80,7 +82,7 @@
|
|
|
80
82
|
"access": "public"
|
|
81
83
|
},
|
|
82
84
|
"dependencies": {
|
|
83
|
-
"@cyanheads/mcp-ts-core": "^0.9.
|
|
85
|
+
"@cyanheads/mcp-ts-core": "^0.9.21",
|
|
84
86
|
"pino-pretty": "^13.1.3",
|
|
85
87
|
"zod": "^4.4.3"
|
|
86
88
|
},
|
|
@@ -88,11 +90,11 @@
|
|
|
88
90
|
"@biomejs/biome": "^2.4.16",
|
|
89
91
|
"@opentelemetry/api": "^1.9.1",
|
|
90
92
|
"@types/node": "^25.9.1",
|
|
91
|
-
"@vitest/coverage-istanbul": "^4.1.
|
|
93
|
+
"@vitest/coverage-istanbul": "^4.1.8",
|
|
92
94
|
"depcheck": "^1.4.7",
|
|
93
95
|
"ignore": "^7.0.5",
|
|
94
96
|
"tsc-alias": "^1.8.17",
|
|
95
97
|
"typescript": "^6.0.3",
|
|
96
|
-
"vitest": "^4.1.
|
|
98
|
+
"vitest": "^4.1.8"
|
|
97
99
|
}
|
|
98
100
|
}
|
package/server.json
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
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.8",
|
|
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.8",
|
|
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.8",
|
|
58
58
|
"packageArguments": [
|
|
59
59
|
{
|
|
60
60
|
"type": "positional",
|