@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 +1 -1
- package/CLAUDE.md +1 -1
- package/Dockerfile +6 -3
- package/README.md +25 -2
- package/changelog/0.1.x/0.1.1.md +17 -0
- package/changelog/0.1.x/0.1.2.md +15 -0
- package/package.json +5 -4
- package/server.json +9 -3
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.
|
|
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.
|
|
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
|
-
|
|
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="
|
|
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
|
|
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
|
-
[](./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
|
|
|
@@ -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.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"mcpName": "io.github.cyanheads/faa-aircraft-registry-mcp-server",
|
|
5
|
-
"description": "
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
72
|
+
"version": "0.1.2",
|
|
67
73
|
"packageArguments": [
|
|
68
74
|
{
|
|
69
75
|
"type": "positional",
|