@cyanheads/faa-aircraft-registry-mcp-server 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** faa-aircraft-registry-mcp-server
4
- **Version:** 0.1.0
4
+ **Version:** 0.1.2
5
5
  **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.6`
6
6
  **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
7
  **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
package/CLAUDE.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** faa-aircraft-registry-mcp-server
4
- **Version:** 0.1.0
4
+ **Version:** 0.1.2
5
5
  **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.6`
6
6
  **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
7
  **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
package/Dockerfile CHANGED
@@ -11,8 +11,11 @@ WORKDIR /usr/src/app
11
11
  # Copy dependency manifests for optimized layer caching
12
12
  COPY package.json bun.lock ./
13
13
 
14
- # Install all dependencies (including dev dependencies for building)
15
- RUN bun install --frozen-lockfile
14
+ # Install all dependencies (including dev dependencies for building). Skip
15
+ # lifecycle scripts so the optional `better-sqlite3` native addon isn't compiled
16
+ # (node-gyp toolchain is absent on the bun base image) — the runtime uses Bun's
17
+ # built-in `bun:sqlite`, so the addon is never loaded in this image.
18
+ RUN bun install --frozen-lockfile --ignore-scripts
16
19
 
17
20
  # Copy the rest of the source code
18
21
  COPY . .
@@ -39,7 +42,7 @@ ENV NODE_ENV=production
39
42
  # OCI image metadata (https://github.com/opencontainers/image-spec/blob/main/annotations.md)
40
43
  ARG APP_VERSION
41
44
  LABEL org.opencontainers.image.title="faa-aircraft-registry-mcp-server"
42
- LABEL org.opencontainers.image.description="Offline, keyless MCP server for the US civil aircraft registry (FAA Releasable Aircraft Database) — decode an N-number to aircraft, engine, status, and owner; search by owner, type, or state."
45
+ LABEL org.opencontainers.image.description="Decode N-numbers to aircraft, engine, status, and owner, and search the US civil aircraft registry (FAA Releasable Aircraft Database) by owner, type, or state — offline and keyless over an embedded SQLite + FTS5 mirror, with fail-safe owner-PII redaction."
43
46
  LABEL org.opencontainers.image.licenses="Apache-2.0"
44
47
  LABEL org.opencontainers.image.version="${APP_VERSION}"
45
48
  LABEL org.opencontainers.image.source="https://github.com/cyanheads/faa-aircraft-registry-mcp-server"
package/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <div align="center">
2
- <h1>faa-aircraft-registry-mcp-server</h1>
2
+ <h1>@cyanheads/faa-aircraft-registry-mcp-server</h1>
3
3
  <p><b>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.</b>
4
4
  <div>5 Tools • 1 Resource</div>
5
5
  </p>
@@ -7,7 +7,7 @@
7
7
 
8
8
  <div align="center">
9
9
 
10
- [![Version](https://img.shields.io/badge/Version-0.1.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/faa-aircraft-registry-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/%40cyanheads%2Ffaa-aircraft-registry-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/faa-aircraft-registry-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.1.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/faa-aircraft-registry-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/%40cyanheads%2Ffaa-aircraft-registry-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/faa-aircraft-registry-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
11
 
12
12
  </div>
13
13
 
@@ -19,6 +19,12 @@
19
19
 
20
20
  </div>
21
21
 
22
+ <div align="center">
23
+
24
+ **Public Hosted Server:** [https://faa-aircraft-registry.caseyjhand.com/mcp](https://faa-aircraft-registry.caseyjhand.com/mcp)
25
+
26
+ </div>
27
+
22
28
  ---
23
29
 
24
30
  ## Overview
@@ -121,6 +127,23 @@ Agent-friendly output:
121
127
 
122
128
  ## Getting started
123
129
 
130
+ ### Public Hosted Instance
131
+
132
+ A public instance is available at `https://faa-aircraft-registry.caseyjhand.com/mcp` — no installation required. Point any MCP client at it via Streamable HTTP:
133
+
134
+ ```json
135
+ {
136
+ "mcpServers": {
137
+ "faa-aircraft-registry-mcp-server": {
138
+ "type": "streamable-http",
139
+ "url": "https://faa-aircraft-registry.caseyjhand.com/mcp"
140
+ }
141
+ }
142
+ }
143
+ ```
144
+
145
+ ### Self-Hosted / Local
146
+
124
147
  > **First run requires building the local index — see [First-run setup](#first-run-setup) below.** The package does not ship the FAA data; until `mirror:init` has run once, queries fail with a clear "run mirror:init" error.
125
148
 
126
149
  Add the following to your MCP client configuration file:
@@ -0,0 +1,17 @@
1
+ ---
2
+ summary: "Metadata polish — action-first package and plugin descriptions, npm-scoped README header, and a repository field on the MCPB manifest."
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.1.1 — 2026-06-14
8
+
9
+ ## Added
10
+
11
+ - **`manifest.json` `repository`** — added the git repository object to the MCPB manifest.
12
+
13
+ ## Changed
14
+
15
+ - **Descriptions** — rewrote `package.json`, `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`, and the Docker OCI image label to lead with the action (decode N-numbers, search the registry) rather than the format.
16
+ - **README `<h1>`** — now the scoped package name `@cyanheads/faa-aircraft-registry-mcp-server`, matching the published npm identity.
17
+ - **Dependencies** — `better-sqlite3` ^12.10.0 → ^12.10.1.
@@ -0,0 +1,15 @@
1
+ ---
2
+ summary: "Public hosted endpoint at faa-aircraft-registry.caseyjhand.com/mcp"
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.1.2 — 2026-06-15
8
+
9
+ ## Added
10
+
11
+ - **Public hosted instance** — `https://faa-aircraft-registry.caseyjhand.com/mcp` declared in `server.json` `remotes[]` and documented in README (link near top + Streamable HTTP config snippet under Getting Started).
12
+
13
+ ## Changed
14
+
15
+ - **Dependencies** — `vitest` ^4.1.8 → ^4.1.9.
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@cyanheads/faa-aircraft-registry-mcp-server",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "mcpName": "io.github.cyanheads/faa-aircraft-registry-mcp-server",
5
- "description": "Offline, keyless MCP server for the US civil aircraft registry (FAA Releasable Aircraft Database) — decode an N-number to aircraft, engine, status, and owner; search by owner, type, or state; resolve active/deregistered/reserved status. Embedded SQLite + FTS5, fail-safe owner-PII redaction.",
5
+ "description": "Decode N-numbers to aircraft, engine, status, and owner, and search the US civil aircraft registry (FAA Releasable Aircraft Database) by owner, type, or state — offline and keyless over an embedded SQLite + FTS5 mirror, with fail-safe owner-PII redaction.",
6
6
  "type": "module",
7
7
  "main": "dist/index.js",
8
8
  "types": "dist/index.d.ts",
@@ -39,6 +39,7 @@
39
39
  "changelog:build": "bun run scripts/build-changelog.ts",
40
40
  "changelog:check": "bun run scripts/build-changelog.ts --check",
41
41
  "release:github": "bun run scripts/release-github.ts",
42
+ "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
42
43
  "test": "vitest run",
43
44
  "mirror:init": "bun run scripts/faa-mirror-init.ts",
44
45
  "mirror:refresh": "bun run scripts/faa-mirror-refresh.ts",
@@ -111,12 +112,12 @@
111
112
  "devDependencies": {
112
113
  "@biomejs/biome": "2.5.0",
113
114
  "@types/node": "25.9.3",
114
- "better-sqlite3": "^12.0.0",
115
+ "better-sqlite3": "^12.10.1",
115
116
  "depcheck": "^1.4.7",
116
117
  "ignore": "^7.0.5",
117
118
  "tsc-alias": "^1.8.17",
118
119
  "typescript": "^6.0.3",
119
- "vitest": "^4.1.8"
120
+ "vitest": "^4.1.9"
120
121
  },
121
122
  "trustedDependencies": ["better-sqlite3"]
122
123
  }
package/server.json CHANGED
@@ -6,14 +6,20 @@
6
6
  "url": "https://github.com/cyanheads/faa-aircraft-registry-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.1.0",
9
+ "version": "0.1.2",
10
+ "remotes": [
11
+ {
12
+ "type": "streamable-http",
13
+ "url": "https://faa-aircraft-registry.caseyjhand.com/mcp"
14
+ }
15
+ ],
10
16
  "packages": [
11
17
  {
12
18
  "registryType": "npm",
13
19
  "registryBaseUrl": "https://registry.npmjs.org",
14
20
  "identifier": "@cyanheads/faa-aircraft-registry-mcp-server",
15
21
  "runtimeHint": "node",
16
- "version": "0.1.0",
22
+ "version": "0.1.2",
17
23
  "packageArguments": [
18
24
  {
19
25
  "type": "positional",
@@ -63,7 +69,7 @@
63
69
  "registryBaseUrl": "https://registry.npmjs.org",
64
70
  "identifier": "@cyanheads/faa-aircraft-registry-mcp-server",
65
71
  "runtimeHint": "node",
66
- "version": "0.1.0",
72
+ "version": "0.1.2",
67
73
  "packageArguments": [
68
74
  {
69
75
  "type": "positional",