@cyanheads/faa-aircraft-registry-mcp-server 0.1.3 → 0.1.5
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 +3 -3
- package/CLAUDE.md +3 -3
- package/Dockerfile +10 -6
- package/LICENSE +1 -1
- package/README.md +4 -3
- package/changelog/0.1.x/0.1.4.md +31 -0
- package/changelog/0.1.x/0.1.5.md +15 -0
- package/changelog/template.md +5 -3
- package/dist/mcp-server/tools/definitions/index.d.ts +6 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-aircraft-types.tool.d.ts +4 -1
- package/dist/mcp-server/tools/definitions/search-aircraft-types.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-aircraft-types.tool.js +41 -9
- package/dist/mcp-server/tools/definitions/search-aircraft-types.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-registrations.tool.d.ts +9 -5
- package/dist/mcp-server/tools/definitions/search-registrations.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-registrations.tool.js +46 -13
- package/dist/mcp-server/tools/definitions/search-registrations.tool.js.map +1 -1
- package/dist/services/registry/csv.d.ts +11 -5
- package/dist/services/registry/csv.d.ts.map +1 -1
- package/dist/services/registry/csv.js +38 -39
- package/dist/services/registry/csv.js.map +1 -1
- package/dist/services/registry/ingest.d.ts +18 -6
- package/dist/services/registry/ingest.d.ts.map +1 -1
- package/dist/services/registry/ingest.js +144 -101
- package/dist/services/registry/ingest.js.map +1 -1
- package/dist/services/registry/normalize.d.ts +21 -5
- package/dist/services/registry/normalize.d.ts.map +1 -1
- package/dist/services/registry/normalize.js +24 -6
- package/dist/services/registry/normalize.js.map +1 -1
- package/dist/services/registry/registry-service.d.ts.map +1 -1
- package/dist/services/registry/registry-service.js +43 -12
- package/dist/services/registry/registry-service.js.map +1 -1
- package/dist/services/registry/schema.d.ts +16 -1
- package/dist/services/registry/schema.d.ts.map +1 -1
- package/dist/services/registry/schema.js +16 -1
- package/dist/services/registry/schema.js.map +1 -1
- package/dist/services/registry/types.d.ts +8 -2
- package/dist/services/registry/types.d.ts.map +1 -1
- package/dist/services/registry/types.js.map +1 -1
- package/dist/services/registry/zip.d.ts +30 -12
- package/dist/services/registry/zip.d.ts.map +1 -1
- package/dist/services/registry/zip.js +58 -28
- package/dist/services/registry/zip.js.map +1 -1
- package/package.json +9 -7
- package/server.json +3 -3
package/AGENTS.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** faa-aircraft-registry-mcp-server
|
|
4
|
-
**Version:** 0.1.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.
|
|
4
|
+
**Version:** 0.1.5
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.14`
|
|
6
6
|
**Engines:** Bun ≥1.3.0, Node ≥24.0.0
|
|
7
7
|
**MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
|
|
8
8
|
**Zod:** ^4.4.3
|
|
@@ -309,7 +309,6 @@ Available skills:
|
|
|
309
309
|
| `tool-defs-analysis` | Read-only audit of MCP definition language across the surface — voice, leaks, defaults, recovery hints, output descriptions |
|
|
310
310
|
| `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
|
|
311
311
|
| `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
|
|
312
|
-
| `devcheck` | Lint, format, typecheck, audit |
|
|
313
312
|
| `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
|
|
314
313
|
| `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
|
|
315
314
|
| `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
|
|
@@ -317,6 +316,7 @@ Available skills:
|
|
|
317
316
|
| `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
|
|
318
317
|
| `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
|
|
319
318
|
| `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
|
|
319
|
+
| `techniques` | Catalog of response/data-shaping techniques — overflow handling, payload shaping, retrieval patterns |
|
|
320
320
|
| `api-auth` | Auth modes, scopes, JWT/OAuth |
|
|
321
321
|
| `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
|
|
322
322
|
| `api-config` | AppConfig, parseConfig, env vars |
|
package/CLAUDE.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** faa-aircraft-registry-mcp-server
|
|
4
|
-
**Version:** 0.1.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.
|
|
4
|
+
**Version:** 0.1.5
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.14`
|
|
6
6
|
**Engines:** Bun ≥1.3.0, Node ≥24.0.0
|
|
7
7
|
**MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
|
|
8
8
|
**Zod:** ^4.4.3
|
|
@@ -309,7 +309,6 @@ Available skills:
|
|
|
309
309
|
| `tool-defs-analysis` | Read-only audit of MCP definition language across the surface — voice, leaks, defaults, recovery hints, output descriptions |
|
|
310
310
|
| `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
|
|
311
311
|
| `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
|
|
312
|
-
| `devcheck` | Lint, format, typecheck, audit |
|
|
313
312
|
| `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
|
|
314
313
|
| `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
|
|
315
314
|
| `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
|
|
@@ -317,6 +316,7 @@ Available skills:
|
|
|
317
316
|
| `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
|
|
318
317
|
| `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
|
|
319
318
|
| `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
|
|
319
|
+
| `techniques` | Catalog of response/data-shaping techniques — overflow handling, payload shaping, retrieval patterns |
|
|
320
320
|
| `api-auth` | Auth modes, scopes, JWT/OAuth |
|
|
321
321
|
| `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
|
|
322
322
|
| `api-config` | AppConfig, parseConfig, env vars |
|
package/Dockerfile
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
# This stage installs all dependencies (including dev), builds the TypeScript
|
|
5
5
|
# source code into JavaScript, and prepares the production assets.
|
|
6
6
|
# ==============================================================================
|
|
7
|
-
FROM oven/bun:1.3 AS build
|
|
7
|
+
FROM oven/bun:1.3.14 AS build
|
|
8
8
|
|
|
9
9
|
WORKDIR /usr/src/app
|
|
10
10
|
|
|
@@ -15,7 +15,9 @@ COPY package.json bun.lock ./
|
|
|
15
15
|
# lifecycle scripts so the optional `better-sqlite3` native addon isn't compiled
|
|
16
16
|
# (node-gyp toolchain is absent on the bun base image) — the runtime uses Bun's
|
|
17
17
|
# built-in `bun:sqlite`, so the addon is never loaded in this image.
|
|
18
|
-
|
|
18
|
+
# The BuildKit cache mount persists Bun's global package cache across builds.
|
|
19
|
+
RUN --mount=type=cache,target=/root/.bun/install/cache \
|
|
20
|
+
bun install --frozen-lockfile --ignore-scripts
|
|
19
21
|
|
|
20
22
|
# Copy the rest of the source code
|
|
21
23
|
COPY . .
|
|
@@ -31,7 +33,7 @@ RUN bun run build
|
|
|
31
33
|
# application. It uses a slim base image and only includes production
|
|
32
34
|
# dependencies and build artifacts.
|
|
33
35
|
# ==============================================================================
|
|
34
|
-
FROM oven/bun:1.3-slim AS production
|
|
36
|
+
FROM oven/bun:1.3.14-slim AS production
|
|
35
37
|
|
|
36
38
|
WORKDIR /usr/src/app
|
|
37
39
|
|
|
@@ -42,7 +44,7 @@ ENV NODE_ENV=production
|
|
|
42
44
|
# OCI image metadata (https://github.com/opencontainers/image-spec/blob/main/annotations.md)
|
|
43
45
|
ARG APP_VERSION
|
|
44
46
|
LABEL org.opencontainers.image.title="faa-aircraft-registry-mcp-server"
|
|
45
|
-
LABEL org.opencontainers.image.description="Decode N-numbers to aircraft, engine, status, and owner
|
|
47
|
+
LABEL org.opencontainers.image.description="Decode N-numbers to aircraft, engine, status, and owner; search the US civil aircraft registry by owner, type, or state; resolve active/deregistered/reserved status — offline via MCP. STDIO or Streamable HTTP."
|
|
46
48
|
LABEL org.opencontainers.image.licenses="Apache-2.0"
|
|
47
49
|
LABEL org.opencontainers.image.version="${APP_VERSION}"
|
|
48
50
|
LABEL org.opencontainers.image.source="https://github.com/cyanheads/faa-aircraft-registry-mcp-server"
|
|
@@ -52,13 +54,15 @@ COPY package.json bun.lock ./
|
|
|
52
54
|
|
|
53
55
|
# Install only production dependencies, ignoring any lifecycle scripts (like 'prepare')
|
|
54
56
|
# that are not needed in the final production image.
|
|
55
|
-
RUN bun
|
|
57
|
+
RUN --mount=type=cache,target=/root/.bun/install/cache \
|
|
58
|
+
bun install --production --frozen-lockfile --ignore-scripts
|
|
56
59
|
|
|
57
60
|
# Conditionally install OpenTelemetry optional peer dependencies (Tier 3).
|
|
58
61
|
# These are not bundled by default to keep the base image lean. Enable at build time
|
|
59
62
|
# with: docker build --build-arg OTEL_ENABLED=true
|
|
60
63
|
ARG OTEL_ENABLED=true
|
|
61
|
-
RUN
|
|
64
|
+
RUN --mount=type=cache,target=/root/.bun/install/cache \
|
|
65
|
+
if [ "$OTEL_ENABLED" = "true" ]; then \
|
|
62
66
|
bun add @hono/otel \
|
|
63
67
|
@opentelemetry/instrumentation-http \
|
|
64
68
|
@opentelemetry/exporter-metrics-otlp-http \
|
package/LICENSE
CHANGED
|
@@ -186,7 +186,7 @@ Apache License
|
|
|
186
186
|
same "printed page" as the copyright notice for easier
|
|
187
187
|
identification within third-party archives.
|
|
188
188
|
|
|
189
|
-
Copyright
|
|
189
|
+
Copyright 2026 Casey Hand @cyanheads
|
|
190
190
|
|
|
191
191
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
192
192
|
you may not use this file except in compliance with the License.
|
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/faa-aircraft-registry-mcp-server) [](https://modelcontextprotocol.io/) [](https://www.npmjs.com/package/@cyanheads/faa-aircraft-registry-mcp-server) [](https://www.typescriptlang.org/) [](https://bun.sh/)
|
|
11
11
|
|
|
12
12
|
</div>
|
|
13
13
|
|
|
@@ -78,8 +78,9 @@ Full-text search over active registrations, returning decoded summaries with N-n
|
|
|
78
78
|
|
|
79
79
|
- Filter by `ownerName`, `makeModel`, `state`, `aircraftType`, or `modeSCode`; at least one filter is required
|
|
80
80
|
- **Owner-name search is disabled when `FAA_REDACT_OWNER_PII` is on** — search by make/model, state, type, or Mode S code instead
|
|
81
|
+
- Free-text terms are column-scoped: `makeModel` matches make/model only, never owner name or city
|
|
81
82
|
- Each result carries an N-number to pass to `faa_lookup_registration` for full detail
|
|
82
|
-
-
|
|
83
|
+
- Every response reports `totalCount` across all matches, so a partial result set is never mistaken for complete; page through it with `limit` (1–200, default 25) and `offset` — a truncated response names the `nextOffset` to request
|
|
83
84
|
|
|
84
85
|
---
|
|
85
86
|
|
|
@@ -89,7 +90,7 @@ Discover the 7-char manufacturer/model/series codes by name before decoding them
|
|
|
89
90
|
|
|
90
91
|
- Filter by `query` (manufacturer/model name, full-text), `aircraftType` code, or `category` code; at least one filter is required
|
|
91
92
|
- Returns reference summaries with the code to pass to `faa_get_aircraft_type`
|
|
92
|
-
-
|
|
93
|
+
- Every response reports `totalCount` across all matches; page through it with `limit` (1–200, default 25) and `offset` — a truncated response names the `nextOffset` to request
|
|
93
94
|
|
|
94
95
|
## Resources
|
|
95
96
|
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "Column-scopes faa_search_registrations FTS matching to close a PII-redaction bypass, adds offset pagination to both search tools, corrects 'bundled registry' description drift, and adopts mcp-ts-core ^0.10.14 with a bun install supply-chain guard."
|
|
3
|
+
breaking: false
|
|
4
|
+
security: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.1.4 — 2026-07-15
|
|
8
|
+
|
|
9
|
+
## Added
|
|
10
|
+
|
|
11
|
+
- **`faa_search_registrations` / `faa_search_aircraft_types`** — `offset` input and `totalCount`/`nextOffset` enrichment fields for paging through capped result sets ([#4](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/4)).
|
|
12
|
+
|
|
13
|
+
## Changed
|
|
14
|
+
|
|
15
|
+
- **`faa_search_registrations` / `faa_search_aircraft_types`** — `truncated` now means "more results remain beyond this page" instead of "the result set was capped." Identical for every existing `offset=0` caller; only pagination walkers observe the new meaning ([#4](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/4)).
|
|
16
|
+
- **Docs** — `search-registrations.tool.ts` and `docs/design.md` corrected from "bundled registry"/"bundled on disk" to "local registry index"/"indexed on disk," matching the README's existing "not bundled" framing ([#2](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/2)).
|
|
17
|
+
- **Framework** — `@cyanheads/mcp-ts-core` `^0.10.9` → `^0.10.14`; re-synced 12 agent skills and 4 devcheck scripts to match.
|
|
18
|
+
- **`bunfig.toml`** — added a supply-chain guard: `install.minimumReleaseAge` blocks packages published under 3 days old (first-party `@cyanheads/mcp-ts-core` excluded), and `install.security.scanner` wires in `@socketsecurity/bun-security-scanner`.
|
|
19
|
+
|
|
20
|
+
## Security
|
|
21
|
+
|
|
22
|
+
- **`faa_search_registrations`** — `makeModel` and `ownerName` free-text search is now column-scoped (`make`/`model` only; `owner_name`/`other_names` only) instead of matching every indexed FTS column. A `makeModel` query previously also matched `city` and `owner_name`, letting search probe fields the owner-PII redaction gate is meant to withhold; a search term that escapes to an empty FTS clause now returns zero results instead of silently matching every row ([#3](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/3)).
|
|
23
|
+
|
|
24
|
+
## Dependencies
|
|
25
|
+
|
|
26
|
+
- `@cyanheads/mcp-ts-core` `^0.10.9` → `^0.10.14`
|
|
27
|
+
- `@biomejs/biome` `2.5.0` → `2.5.2`
|
|
28
|
+
- `@types/node` `26.0.0` → `26.1.1`
|
|
29
|
+
- `tsc-alias` `^1.8.17` → `^1.9.0`
|
|
30
|
+
- `js-yaml` `3.14.2` → `3.15.0` (transitive via `depcheck`; clears GHSA-h67p-54hq-rp68 — not from the core bump)
|
|
31
|
+
- Added `@socketsecurity/bun-security-scanner` `^1.1.2`
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "Bounds registry rebuild peak memory to the largest single file via lazy ZIP inflation, streamed line parsing, and chunked auxiliary transactions (measured ~2.35 GiB to ~0.74 GiB); syncs the Dockerfile OCI description label to package.json."
|
|
3
|
+
breaking: false
|
|
4
|
+
security: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.1.5 — 2026-07-16
|
|
8
|
+
|
|
9
|
+
## Changed
|
|
10
|
+
|
|
11
|
+
- **Dockerfile** — `org.opencontainers.image.description` OCI label synced to `package.json`'s current description (previously carried older wording).
|
|
12
|
+
|
|
13
|
+
## Fixed
|
|
14
|
+
|
|
15
|
+
- **Registry rebuild** — full mirror rebuild (`mirror:init`/`mirror:refresh`) peak memory now scales with the **largest single file** in the FAA archive instead of the sum of all files, via lazy per-entry ZIP inflation (`zip.ts`'s `openZipArchive`/`readEntry`, replacing eager `readZipEntries`), streamed latin1 line decoding (`csv.ts`'s `parseCsv` now takes the raw entry `Buffer`), and `PAGE_SIZE`-chunked auxiliary-table transactions. Measured peak RSS on a real `mirror:refresh` dropped from ~2.35 GiB to ~0.74 GiB, with identical row counts ([#6](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/6)).
|
package/changelog/template.md
CHANGED
|
@@ -15,9 +15,11 @@ summary: ""
|
|
|
15
15
|
# usage. Flagged as `Breaking` in the rollup.
|
|
16
16
|
breaking: false
|
|
17
17
|
|
|
18
|
-
# Set `true`
|
|
19
|
-
#
|
|
20
|
-
#
|
|
18
|
+
# Set `true` ONLY for a security fix in THIS project's own source code — a
|
|
19
|
+
# vulnerability or hardening in code you ship. A dependency or transitive CVE
|
|
20
|
+
# bump is routine maintenance, NOT a security release: record it under
|
|
21
|
+
# `## Dependencies` (with the advisory ID) and leave this `false`. When true,
|
|
22
|
+
# pairs with the `## Security` section below and flags `Security` in the rollup.
|
|
21
23
|
security: false
|
|
22
24
|
|
|
23
25
|
# Optional free-form notes for maintenance agents processing this release.
|
|
@@ -140,6 +140,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
140
140
|
aircraftType: import("zod").ZodOptional<import("zod").ZodString>;
|
|
141
141
|
category: import("zod").ZodOptional<import("zod").ZodString>;
|
|
142
142
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
143
|
+
offset: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
143
144
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
144
145
|
aircraftTypes: import("zod").ZodArray<import("zod").ZodObject<{
|
|
145
146
|
code: import("zod").ZodString;
|
|
@@ -162,6 +163,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
162
163
|
readonly when: "No search filter was supplied.";
|
|
163
164
|
readonly recovery: "Provide a query (manufacturer/model name), an aircraftType code, or a category code to search.";
|
|
164
165
|
}], {
|
|
166
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
167
|
+
readonly nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
165
168
|
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
166
169
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
167
170
|
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
@@ -173,6 +176,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
173
176
|
aircraftType: import("zod").ZodOptional<import("zod").ZodString>;
|
|
174
177
|
modeSCode: import("zod").ZodOptional<import("zod").ZodString>;
|
|
175
178
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
179
|
+
offset: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
176
180
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
177
181
|
registrations: import("zod").ZodArray<import("zod").ZodObject<{
|
|
178
182
|
nNumber: import("zod").ZodString;
|
|
@@ -204,6 +208,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
204
208
|
readonly when: "No search filter was supplied.";
|
|
205
209
|
readonly recovery: "Provide at least one of makeModel, state, aircraftType, or modeSCode (or ownerName when owner PII is unredacted).";
|
|
206
210
|
}], {
|
|
211
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
212
|
+
readonly nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
207
213
|
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
208
214
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
209
215
|
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,kBAAkB
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAM9B,CAAC"}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* @fileoverview faa_search_aircraft_types — search the aircraft reference table by
|
|
3
3
|
* manufacturer/model name, aircraft type, or category to discover the 7-char
|
|
4
4
|
* manufacturer/model codes and browse specs. Fills the discovery gap before
|
|
5
|
-
* faa_get_aircraft_type. Discloses
|
|
5
|
+
* faa_get_aircraft_type. Discloses the total match count and pages via offset.
|
|
6
6
|
* @module mcp-server/tools/definitions/search-aircraft-types.tool
|
|
7
7
|
*/
|
|
8
8
|
import { z } from '@cyanheads/mcp-ts-core';
|
|
@@ -12,6 +12,7 @@ export declare const searchAircraftTypesTool: import("@cyanheads/mcp-ts-core").T
|
|
|
12
12
|
aircraftType: z.ZodOptional<z.ZodString>;
|
|
13
13
|
category: z.ZodOptional<z.ZodString>;
|
|
14
14
|
limit: z.ZodDefault<z.ZodNumber>;
|
|
15
|
+
offset: z.ZodDefault<z.ZodNumber>;
|
|
15
16
|
}, z.core.$strip>, z.ZodObject<{
|
|
16
17
|
aircraftTypes: z.ZodArray<z.ZodObject<{
|
|
17
18
|
code: z.ZodString;
|
|
@@ -34,6 +35,8 @@ export declare const searchAircraftTypesTool: import("@cyanheads/mcp-ts-core").T
|
|
|
34
35
|
readonly when: "No search filter was supplied.";
|
|
35
36
|
readonly recovery: "Provide a query (manufacturer/model name), an aircraftType code, or a category code to search.";
|
|
36
37
|
}], {
|
|
38
|
+
readonly totalCount: z.ZodNumber;
|
|
39
|
+
readonly nextOffset: z.ZodOptional<z.ZodNumber>;
|
|
37
40
|
readonly truncated: z.ZodOptional<z.ZodBoolean>;
|
|
38
41
|
readonly shown: z.ZodOptional<z.ZodNumber>;
|
|
39
42
|
readonly cap: z.ZodOptional<z.ZodNumber>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-aircraft-types.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-aircraft-types.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwBjE,eAAO,MAAM,uBAAuB
|
|
1
|
+
{"version":3,"file":"search-aircraft-types.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-aircraft-types.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwBjE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgJlC,CAAC"}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* @fileoverview faa_search_aircraft_types — search the aircraft reference table by
|
|
3
3
|
* manufacturer/model name, aircraft type, or category to discover the 7-char
|
|
4
4
|
* manufacturer/model codes and browse specs. Fills the discovery gap before
|
|
5
|
-
* faa_get_aircraft_type. Discloses
|
|
5
|
+
* faa_get_aircraft_type. Discloses the total match count and pages via offset.
|
|
6
6
|
* @module mcp-server/tools/definitions/search-aircraft-types.tool
|
|
7
7
|
*/
|
|
8
8
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
@@ -26,7 +26,7 @@ const aircraftTypeSummarySchema = z
|
|
|
26
26
|
.describe('A decoded aircraft-reference summary; use code with faa_get_aircraft_type for full specs.');
|
|
27
27
|
export const searchAircraftTypesTool = tool('faa_search_aircraft_types', {
|
|
28
28
|
title: 'faa-aircraft-registry-mcp-server: search aircraft types',
|
|
29
|
-
description: 'Search the FAA aircraft reference table by manufacturer/model name (full-text), aircraft type code, or category code to discover 7-character manufacturer/model/series codes and browse specifications. Use this before faa_get_aircraft_type to find a code by name. At least one filter is required.
|
|
29
|
+
description: 'Search the FAA aircraft reference table by manufacturer/model name (full-text), aircraft type code, or category code to discover 7-character manufacturer/model/series codes and browse specifications. Use this before faa_get_aircraft_type to find a code by name. At least one filter is required. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward.',
|
|
30
30
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
|
|
31
31
|
input: z.object({
|
|
32
32
|
query: z.string().optional().describe('Manufacturer and/or model name to match (full-text).'),
|
|
@@ -45,23 +45,42 @@ export const searchAircraftTypesTool = tool('faa_search_aircraft_types', {
|
|
|
45
45
|
.max(200)
|
|
46
46
|
.default(25)
|
|
47
47
|
.describe('Maximum number of results to return (1–200, default 25).'),
|
|
48
|
+
offset: z
|
|
49
|
+
.number()
|
|
50
|
+
.int()
|
|
51
|
+
.min(0)
|
|
52
|
+
.default(0)
|
|
53
|
+
.describe('Zero-based index of the first result to return — pass the nextOffset from a previous response, with identical filters, to page forward (default 0).'),
|
|
48
54
|
}),
|
|
49
55
|
output: z.object({
|
|
50
56
|
aircraftTypes: z
|
|
51
57
|
.array(aircraftTypeSummarySchema)
|
|
52
|
-
.describe('Matching aircraft-reference summaries (up to limit).'),
|
|
58
|
+
.describe('Matching aircraft-reference summaries for this page (up to limit).'),
|
|
53
59
|
}),
|
|
54
60
|
enrichment: {
|
|
61
|
+
totalCount: z
|
|
62
|
+
.number()
|
|
63
|
+
.describe('Total aircraft types matching the filters, across all pages. Always present.'),
|
|
64
|
+
nextOffset: z
|
|
65
|
+
.number()
|
|
66
|
+
.optional()
|
|
67
|
+
.describe('Offset to request the next page; absent when this page reached the end of the matches.'),
|
|
55
68
|
truncated: z
|
|
56
69
|
.boolean()
|
|
57
70
|
.optional()
|
|
58
|
-
.describe('Present and true only when
|
|
59
|
-
shown: z
|
|
60
|
-
|
|
71
|
+
.describe('Present and true only when matches remain beyond this page.'),
|
|
72
|
+
shown: z
|
|
73
|
+
.number()
|
|
74
|
+
.optional()
|
|
75
|
+
.describe('Number of results on this page (present only when truncated is set).'),
|
|
76
|
+
cap: z
|
|
77
|
+
.number()
|
|
78
|
+
.optional()
|
|
79
|
+
.describe('The limit that was applied (present only when truncated is set).'),
|
|
61
80
|
notice: z
|
|
62
81
|
.string()
|
|
63
82
|
.optional()
|
|
64
|
-
.describe('Guidance when no aircraft types matched
|
|
83
|
+
.describe('Guidance when no aircraft types matched, or when more matches remain.'),
|
|
65
84
|
},
|
|
66
85
|
errors: [
|
|
67
86
|
{
|
|
@@ -86,12 +105,25 @@ export const searchAircraftTypesTool = tool('faa_search_aircraft_types', {
|
|
|
86
105
|
...(aircraftType ? { aircraftType } : {}),
|
|
87
106
|
...(category ? { category } : {}),
|
|
88
107
|
limit: input.limit,
|
|
108
|
+
offset: input.offset,
|
|
89
109
|
}, ctx);
|
|
110
|
+
// Always populated — a required enrichment field must survive every success
|
|
111
|
+
// path, including the zero-result one.
|
|
112
|
+
ctx.enrich.total(page.totalCount);
|
|
113
|
+
const nextOffset = input.offset + page.items.length;
|
|
114
|
+
if (page.truncated)
|
|
115
|
+
ctx.enrich({ nextOffset });
|
|
90
116
|
if (page.items.length === 0) {
|
|
91
|
-
ctx.enrich.notice(
|
|
117
|
+
ctx.enrich.notice(page.totalCount > 0
|
|
118
|
+
? `Offset ${input.offset} is past the end of this result set — ${page.totalCount} aircraft types match, but none remain at that offset. Retry with a lower offset.`
|
|
119
|
+
: 'No aircraft types matched the supplied filters. Broaden the name query or verify the type/category code.');
|
|
92
120
|
}
|
|
93
121
|
if (page.truncated) {
|
|
94
|
-
ctx.enrich.truncated({
|
|
122
|
+
ctx.enrich.truncated({
|
|
123
|
+
shown: page.items.length,
|
|
124
|
+
cap: page.cap,
|
|
125
|
+
guidance: `Showing ${page.items.length} of ${page.totalCount} matching aircraft types. Call faa_search_aircraft_types again with the same filters and offset: ${nextOffset} for the next page.`,
|
|
126
|
+
});
|
|
95
127
|
}
|
|
96
128
|
return { aircraftTypes: page.items };
|
|
97
129
|
},
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-aircraft-types.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-aircraft-types.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,yBAAyB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,uFAAuF,CACxF;IACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC7D,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACpF,QAAQ,EAAE,gBAAgB;SACvB,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;IACxE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACnF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAChF,CAAC;KACD,QAAQ,CACP,2FAA2F,CAC5F,CAAC;AAEJ,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,2BAA2B,EAAE;IACvE,KAAK,EAAE,yDAAyD;IAChE,WAAW,EACT
|
|
1
|
+
{"version":3,"file":"search-aircraft-types.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-aircraft-types.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @fileoverview faa_search_registrations — search active registrations by owner
|
|
3
|
-
* name, make/model, state, aircraft type, or Mode S code. FTS5 over the
|
|
4
|
-
* index; results are decoded summaries carrying N-numbers for follow-up
|
|
5
|
-
* faa_lookup_registration calls.
|
|
6
|
-
*
|
|
7
|
-
*
|
|
3
|
+
* name, make/model, state, aircraft type, or Mode S code. FTS5 over the local
|
|
4
|
+
* on-disk index; results are decoded summaries carrying N-numbers for follow-up
|
|
5
|
+
* faa_lookup_registration calls. Free-text terms are column-scoped, so makeModel
|
|
6
|
+
* matches make/model only and never owner or city. Owner-name search is disabled
|
|
7
|
+
* when owner-PII redaction is on (so the search input can't be used to confirm a
|
|
8
|
+
* person↔aircraft link). Discloses the total match count and pages via offset.
|
|
8
9
|
* @module mcp-server/tools/definitions/search-registrations.tool
|
|
9
10
|
*/
|
|
10
11
|
import { z } from '@cyanheads/mcp-ts-core';
|
|
@@ -16,6 +17,7 @@ export declare const searchRegistrationsTool: import("@cyanheads/mcp-ts-core").T
|
|
|
16
17
|
aircraftType: z.ZodOptional<z.ZodString>;
|
|
17
18
|
modeSCode: z.ZodOptional<z.ZodString>;
|
|
18
19
|
limit: z.ZodDefault<z.ZodNumber>;
|
|
20
|
+
offset: z.ZodDefault<z.ZodNumber>;
|
|
19
21
|
}, z.core.$strip>, z.ZodObject<{
|
|
20
22
|
registrations: z.ZodArray<z.ZodObject<{
|
|
21
23
|
nNumber: z.ZodString;
|
|
@@ -47,6 +49,8 @@ export declare const searchRegistrationsTool: import("@cyanheads/mcp-ts-core").T
|
|
|
47
49
|
readonly when: "No search filter was supplied.";
|
|
48
50
|
readonly recovery: "Provide at least one of makeModel, state, aircraftType, or modeSCode (or ownerName when owner PII is unredacted).";
|
|
49
51
|
}], {
|
|
52
|
+
readonly totalCount: z.ZodNumber;
|
|
53
|
+
readonly nextOffset: z.ZodOptional<z.ZodNumber>;
|
|
50
54
|
readonly truncated: z.ZodOptional<z.ZodBoolean>;
|
|
51
55
|
readonly shown: z.ZodOptional<z.ZodNumber>;
|
|
52
56
|
readonly cap: z.ZodOptional<z.ZodNumber>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-registrations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-registrations.tool.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"search-registrations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-registrations.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyBjE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6KlC,CAAC"}
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @fileoverview faa_search_registrations — search active registrations by owner
|
|
3
|
-
* name, make/model, state, aircraft type, or Mode S code. FTS5 over the
|
|
4
|
-
* index; results are decoded summaries carrying N-numbers for follow-up
|
|
5
|
-
* faa_lookup_registration calls.
|
|
6
|
-
*
|
|
7
|
-
*
|
|
3
|
+
* name, make/model, state, aircraft type, or Mode S code. FTS5 over the local
|
|
4
|
+
* on-disk index; results are decoded summaries carrying N-numbers for follow-up
|
|
5
|
+
* faa_lookup_registration calls. Free-text terms are column-scoped, so makeModel
|
|
6
|
+
* matches make/model only and never owner or city. Owner-name search is disabled
|
|
7
|
+
* when owner-PII redaction is on (so the search input can't be used to confirm a
|
|
8
|
+
* person↔aircraft link). Discloses the total match count and pages via offset.
|
|
8
9
|
* @module mcp-server/tools/definitions/search-registrations.tool
|
|
9
10
|
*/
|
|
10
11
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
@@ -31,7 +32,7 @@ const registrationSummarySchema = z
|
|
|
31
32
|
.describe('A decoded registration summary; use nNumber with faa_lookup_registration for full detail.');
|
|
32
33
|
export const searchRegistrationsTool = tool('faa_search_registrations', {
|
|
33
34
|
title: 'faa-aircraft-registry-mcp-server: search registrations',
|
|
34
|
-
description: 'Search active US civil aircraft registrations by owner name, make/model, state, aircraft type, or Mode S (hex) code. Full-text search over the
|
|
35
|
+
description: 'Search active US civil aircraft registrations by owner name, make/model, state, aircraft type, or Mode S (hex) code. Full-text search over the local registry index; returns decoded summaries with N-numbers to drill into via faa_lookup_registration. At least one filter is required. Owner-name search is unavailable when this deployment redacts owner PII — search by make/model, state, aircraft type, or Mode S code instead. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward.',
|
|
35
36
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
|
|
36
37
|
input: z.object({
|
|
37
38
|
ownerName: z
|
|
@@ -55,23 +56,42 @@ export const searchRegistrationsTool = tool('faa_search_registrations', {
|
|
|
55
56
|
.max(200)
|
|
56
57
|
.default(25)
|
|
57
58
|
.describe('Maximum number of results to return (1–200, default 25).'),
|
|
59
|
+
offset: z
|
|
60
|
+
.number()
|
|
61
|
+
.int()
|
|
62
|
+
.min(0)
|
|
63
|
+
.default(0)
|
|
64
|
+
.describe('Zero-based index of the first result to return — pass the nextOffset from a previous response, with identical filters, to page forward (default 0).'),
|
|
58
65
|
}),
|
|
59
66
|
output: z.object({
|
|
60
67
|
registrations: z
|
|
61
68
|
.array(registrationSummarySchema)
|
|
62
|
-
.describe('Matching registration summaries (up to limit).'),
|
|
69
|
+
.describe('Matching registration summaries for this page (up to limit).'),
|
|
63
70
|
}),
|
|
64
71
|
enrichment: {
|
|
72
|
+
totalCount: z
|
|
73
|
+
.number()
|
|
74
|
+
.describe('Total registrations matching the filters, across all pages. Always present.'),
|
|
75
|
+
nextOffset: z
|
|
76
|
+
.number()
|
|
77
|
+
.optional()
|
|
78
|
+
.describe('Offset to request the next page; absent when this page reached the end of the matches.'),
|
|
65
79
|
truncated: z
|
|
66
80
|
.boolean()
|
|
67
81
|
.optional()
|
|
68
|
-
.describe('Present and true only when
|
|
69
|
-
shown: z
|
|
70
|
-
|
|
82
|
+
.describe('Present and true only when matches remain beyond this page.'),
|
|
83
|
+
shown: z
|
|
84
|
+
.number()
|
|
85
|
+
.optional()
|
|
86
|
+
.describe('Number of results on this page (present only when truncated is set).'),
|
|
87
|
+
cap: z
|
|
88
|
+
.number()
|
|
89
|
+
.optional()
|
|
90
|
+
.describe('The limit that was applied (present only when truncated is set).'),
|
|
71
91
|
notice: z
|
|
72
92
|
.string()
|
|
73
93
|
.optional()
|
|
74
|
-
.describe('Guidance when no registrations matched
|
|
94
|
+
.describe('Guidance when no registrations matched, or when more matches remain.'),
|
|
75
95
|
},
|
|
76
96
|
errors: [
|
|
77
97
|
{
|
|
@@ -111,12 +131,25 @@ export const searchRegistrationsTool = tool('faa_search_registrations', {
|
|
|
111
131
|
...(aircraftType ? { aircraftType } : {}),
|
|
112
132
|
...(modeSCode ? { modeSCode } : {}),
|
|
113
133
|
limit: input.limit,
|
|
134
|
+
offset: input.offset,
|
|
114
135
|
}, ctx);
|
|
136
|
+
// Always populated — a required enrichment field must survive every success
|
|
137
|
+
// path, including the zero-result one.
|
|
138
|
+
ctx.enrich.total(page.totalCount);
|
|
139
|
+
const nextOffset = input.offset + page.items.length;
|
|
140
|
+
if (page.truncated)
|
|
141
|
+
ctx.enrich({ nextOffset });
|
|
115
142
|
if (page.items.length === 0) {
|
|
116
|
-
ctx.enrich.notice(
|
|
143
|
+
ctx.enrich.notice(page.totalCount > 0
|
|
144
|
+
? `Offset ${input.offset} is past the end of this result set — ${page.totalCount} registrations match, but none remain at that offset. Retry with a lower offset.`
|
|
145
|
+
: 'No registrations matched the supplied filters. Broaden the make/model terms, verify the state or Mode S code, or remove a filter.');
|
|
117
146
|
}
|
|
118
147
|
if (page.truncated) {
|
|
119
|
-
ctx.enrich.truncated({
|
|
148
|
+
ctx.enrich.truncated({
|
|
149
|
+
shown: page.items.length,
|
|
150
|
+
cap: page.cap,
|
|
151
|
+
guidance: `Showing ${page.items.length} of ${page.totalCount} matching registrations. Call faa_search_registrations again with the same filters and offset: ${nextOffset} for the next page.`,
|
|
152
|
+
});
|
|
120
153
|
}
|
|
121
154
|
return { registrations: page.items };
|
|
122
155
|
},
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-registrations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-registrations.tool.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"search-registrations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-registrations.tool.ts"],"names":[],"mappings":"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"}
|