fpv-airspace 0.4.0

package/licences/NATS.md

@@ -0,0 +1,36 @@
+# NATS UK AIP ENR 5.1 UAS Flight Restrictions dataset
+
+Status: **open question**. Redistribution terms have not been confirmed.
+
+## What the dataset is
+
+The UAS Flight Restrictions digital dataset (AIXM 5.1 plus a KML for visual
+validation) published by NATS AIS on behalf of the CAA at
+<https://nats-uk.ead-it.com/cms-nats/opencms/en/Publications/digital-datasets/index.html>,
+refreshed every AIRAC cycle (28 days).
+
+## What the pages say
+
+The dataset pages carry "© Copyright NATS Limited" and no explicit reuse
+licence. The UAS restriction zones page says the datasets were "created to
+allow end users the ability to view the data in separate viewers or integrate
+with other applications". No commercial-use or redistribution statement was
+found on 2026-09-25.
+
+## How this project uses it
+
+- Parsed into the data pack at build time and redistributed as GitHub Release
+  assets so that `npx` users need no NATS account or download of their own.
+- Every response that uses the layer carries the attribution string
+  "Airspace restrictions: UK AIP ENR 5.1 UAS Flight Restrictions dataset
+  © NATS Limited. Reproduced for information only; the UK AIP is the
+  authoritative source."
+- The build supports `--exclude nats` so a pack without the layer can be
+  published if redistribution is refused; the server would then fetch and parse
+  the dataset client-side on first run (parser lives in `pipeline/sources/nats`).
+
+## Correspondence log
+
+| Date | Action |
+|---|---|
+| 2026-09-25 | Terms reviewed; none published. Enquiry to NATS AIS still to be sent. |

package/licences/OGL-3.0.md

@@ -0,0 +1,10 @@
+# Open Government Licence v3.0
+
+Full text: <https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/>
+
+You are free to copy, publish, distribute, transmit and adapt the Information,
+and exploit it commercially and non-commercially, provided you acknowledge the
+source by including the attribution statement specified by the Information
+Provider(s) and, where possible, link to this licence. The attribution strings
+for every OGL source in the pack are stored in the pack's `sources` table and
+printed by `get_data_status`.

package/licences/ONS.md

@@ -0,0 +1,10 @@
+# ONS Countries (December 2024) Boundaries UK BUC
+
+Office for National Statistics licensed under the Open Government Licence v3.
+Contains OS data © Crown copyright and database right 2024.
+Source: <https://geoportal.statistics.gov.uk/>.
+
+Used only to decide whether a point is in England/Wales (rights-of-way data
+available), Scotland or Northern Ireland.
+
+The same licence covers the Local Authority Districts boundaries (BSC, super-generalised) used for the `admin_areas` table and council policy notes.

package/licences/forestry-england.md

@@ -0,0 +1,7 @@
+# Forestry England legal boundary
+
+Forestry England Legal Boundary from the Forestry Commission open data portal (https://data-forestry.opendata.arcgis.com/).
+
+Licence: Open Government Licence v3.0 with a mandatory acknowledgement, reproduced verbatim in the source attribution: "Contains, or is based on, information supplied by the Forestry Commission. © Crown copyright and database right [year] Ordnance Survey [100021242]".
+
+Forestry England byelaws prohibit operating aircraft, including drones, on its land without a permit (https://www.forestryengland.uk/article/filming-photography-and-drones).

package/licences/improvement-service-core-paths.md

@@ -0,0 +1,5 @@
+# Core Paths, Scotland
+
+Core paths under the Land Reform (Scotland) Act 2003, aggregated from every Scottish local authority and National Park authority by the Improvement Service Spatial Hub (https://data.spatialhub.scot/dataset/core_paths-is).
+
+Licence: Open Government Licence v3.0. Access to the WFS and downloads needs a free Spatial Hub account key, supplied to the build as `SPATIALHUB_AUTHKEY`; the account terms are accepted by the key holder. Attribution per council: "Core paths: <council> core path plan via the Improvement Service Spatial Hub, Open Government Licence v3. Contains OS data © Crown copyright and database right".

package/licences/national-trust.md

@@ -0,0 +1,11 @@
+# National Trust Open Data: Land - Always Open / Limited Access
+
+Source: <https://open-data-national-trust.hub.arcgis.com/> (ArcGIS Hub),
+published under the Open Government Licence v3 (Always Open) and CC-BY
+(Limited Access) per data.gov.uk. Captured at approximately 1:50,000; not an
+ownership boundary.
+
+The National Trust Byelaws (1965, made under the National Trust Act 1907)
+prohibit operating an aircraft, including unmanned aircraft, over or from Trust
+land without permission:
+<https://www.nationaltrust.org.uk/who-we-are/about-us/flying-drones-at-our-places>.

package/licences/natural-england.md

@@ -0,0 +1,7 @@
+# Natural England open data
+
+CRoW Act 2000 Access Layer, Sites of Special Scientific Interest (England) and National Parks (England), from the Natural England Open Data Geoportal (https://naturalengland-defra.opendata.arcgis.com/).
+
+Licence: Open Government Licence v3.0. Attribution: "Contains Natural England data © Natural England, and OS data © Crown copyright and database right", with the year of the data.
+
+Used for: open access land (context for take-off, not permission), SSSI and National Park designations (advisory).

package/licences/natural-resources-wales.md

@@ -0,0 +1,5 @@
+# Natural Resources Wales open data
+
+Open Access (open country, registered common land), SSSI and National Park layers from DataMapWales (https://datamap.gov.wales/), served by GeoServer WFS.
+
+Licence: Open Government Licence v3.0. Attribution: "Contains Natural Resources Wales information © Natural Resources Wales and database right. Contains OS data © Crown copyright and database right".

package/licences/nominatim-ODbL.md

@@ -0,0 +1,9 @@
+# Geocoding
+
+- **Nominatim** (default): data © OpenStreetMap contributors, Open Database
+  Licence (ODbL). Usage policy: <https://operations.osmfoundation.org/policies/nominatim/>
+  (max 1 request/second, identifying User-Agent, results cached). The server
+  enforces the rate limit and caches results for 30 days.
+- **OS Names API** (optional, `OS_NAMES_API_KEY`): OS OpenData under the Open
+  Government Licence v3. Contains OS data © Crown copyright and database right.
+- **postcodes.io**: Open Government Licence v3; contains OS and ONS data.

package/licences/openstreetmap-ODbL.md

@@ -0,0 +1,5 @@
+# OpenStreetMap
+
+Parking, laybys and ground hazards (railways, motorways and trunk roads, power lines and pylons, substations and generators, helipads, masts, military land, schools, nurseries, hospitals, fire and fuel stations, parks, cemeteries) come from the Geofabrik Great Britain extract of OpenStreetMap (https://download.geofabrik.de/europe/great-britain.html).
+
+Licence: Open Database Licence (ODbL) 1.0. Attribution: "© OpenStreetMap contributors". Ground hazards are advisory and incomplete; they do not change the legal verdict.

package/licences/rowmaps.md

@@ -0,0 +1,20 @@
+# Public rights of way via rowmaps.com
+
+Each council releases its rights-of-way GIS data under the Open Government
+Licence v3 (a few older releases used OS OpenData terms). rowmaps.com converts
+them to GeoJSON and states per file:
+
+> The data in this GeoJSON file has been obtained under licence from the council
+> of X. The Council's Definitive Map is the authoritative source of their rights
+> of way. The details of the public rights of way network contained in the
+> Council's data are for information only, and are an interpretation of the
+> Definitive Map, not the Definitive Map itself ... The authority's data contains
+> Ordnance Survey data © Crown copyright and database right <year>. ... Data is
+> also provided by www.rowmaps.com © www.rowmaps.com copyright and database
+> right <year>. This file is released with the Open Government Licence. The
+> preceding attribution statements must be contained in any sub-licences.
+
+The pack stores one attribution string per authority (`authorities.attribution`)
+and `check_takeoff_site` prints the attribution of every authority whose paths
+appear in a response. See <https://www.opennetzero.org/> and
+<https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/>.

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "fpv-airspace",
+  "version": "0.4.0",
+  "description": "MCP server answering where a drone can legally take off and fly in the UK: NATS flight restriction zones, live NOTAMs, public rights of way and landowner rules",
+  "type": "module",
+  "bin": {
+    "fpv-airspace": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "licences",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json --noEmit && node scripts/bundle.mjs",
+    "dev": "tsx src/index.ts",
+    "prepare": "npm run build",
+    "lint": "eslint src pipeline scripts test",
+    "lint:fix": "eslint src pipeline scripts test --fix",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc -p tsconfig.pipeline.json --noEmit",
+    "pack:build": "tsx scripts/build-pack.ts",
+    "pack:verify": "tsx scripts/verify-pack.ts",
+    "pack:fetch-nats": "tsx scripts/fetch-nats.ts",
+    "pack:fetch-rowmaps": "tsx scripts/fetch-rowmaps.ts",
+    "pack:fetch-nt": "tsx scripts/fetch-nt.ts",
+    "pack:fetch-countries": "tsx scripts/fetch-countries.ts",
+    "pack:manifest": "tsx scripts/make-manifest.ts",
+    "pack:check-upstream": "tsx scripts/check-upstream.ts",
+    "mcpb:pack": "npm run build && npx --yes @anthropic-ai/mcpb pack . build/fpv-airspace.mcpb",
+    "worker:dev": "wrangler dev",
+    "worker:deploy": "wrangler deploy",
+    "pack:export-d1": "tsx scripts/export-d1.ts",
+    "worker:setup": "scripts/cloudflare-setup.sh",
+    "worker:load": "scripts/d1-load.sh",
+    "pack:fetch-parking": "tsx scripts/fetch-parking.ts",
+    "pack:fetch-hazards": "tsx scripts/fetch-hazards.ts",
+    "pack:fetch-access": "tsx scripts/fetch-access.ts",
+    "pack:fetch-wales": "tsx scripts/fetch-wales.ts",
+    "pack:fetch-forestry": "tsx scripts/fetch-forestry.ts",
+    "pack:fetch-lad": "tsx scripts/fetch-lad.ts",
+    "pack:fetch-corepaths": "tsx scripts/fetch-corepaths.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/noodlemctwoodle/fpv-airspace.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "drone",
+    "uas",
+    "uk",
+    "airspace",
+    "notam",
+    "flight-restriction-zone",
+    "rights-of-way",
+    "claude"
+  ],
+  "author": "Toby Goulden",
+  "license": "MIT",
+  "devDependencies": {
+    "@mapbox/polyline": "^1.2.1",
+    "@modelcontextprotocol/sdk": "^1.30.1",
+    "@tmcw/togeojson": "^7.1.2",
+    "@turf/area": "^7.4.0",
+    "@turf/bbox": "^7.4.0",
+    "@turf/bbox-polygon": "^7.4.0",
+    "@turf/boolean-intersects": "^7.4.0",
+    "@turf/boolean-point-in-polygon": "^7.4.0",
+    "@turf/boolean-valid": "^7.4.0",
+    "@turf/centroid": "^7.4.0",
+    "@turf/circle": "^7.4.0",
+    "@turf/destination": "^7.4.0",
+    "@turf/difference": "^7.4.0",
+    "@turf/distance": "^7.4.0",
+    "@turf/helpers": "^7.4.0",
+    "@turf/intersect": "^7.4.0",
+    "@turf/length": "^7.4.0",
+    "@turf/line-intersect": "^7.4.0",
+    "@turf/line-slice": "^7.4.0",
+    "@turf/nearest-point-on-line": "^7.4.0",
+    "@turf/point-to-line-distance": "^7.4.0",
+    "@turf/rewind": "^7.4.0",
+    "@turf/simplify": "^7.4.0",
+    "@turf/union": "^7.4.0",
+    "@types/express": "^5.0.6",
+    "@types/geojson": "^7946.0.16",
+    "@types/mapbox__polyline": "^1.0.5",
+    "@types/node": "^26.6.2",
+    "@types/proj4": "^2.5.6",
+    "@typescript-eslint/eslint-plugin": "^8.70.1",
+    "@typescript-eslint/parser": "^8.70.1",
+    "@vitest/coverage-v8": "^5.0.2",
+    "@xmldom/xmldom": "^0.9.12",
+    "esbuild": "^0.28.2",
+    "eslint": "^10.11.0",
+    "express": "^5.2.1",
+    "fast-xml-parser": "^5.11.1",
+    "fflate": "^0.8.3",
+    "proj4": "^2.22.0",
+    "tsx": "^4.23.15",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.2",
+    "wrangler": "^4.141.0",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.5"
+  }
+}