@ignfab/geocontext 0.9.3 → 0.9.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ignfab/geocontext",
-  "version": "0.9.3",
+  "version": "0.9.6",
   "description": "An experimental MCP server providing access to the services and data of the french Geoplateform",
   "type": "module",
   "bin": {
@@ -27,9 +27,8 @@
   },
   "homepage": "https://github.com/ignfab/geocontext#readme",
   "scripts": {
-    "clean:dist": "rm -rf dist",
-    "copy:resources": "mkdir -p dist/resources/content && cp -R src/resources/content/. dist/resources/content/",
-    "build": "npm run clean:dist && tsc && npx mcp-build && npm run copy:resources",
+    "clean:dist": "node scripts/dist-clean.js",
+    "build": "npm run clean:dist && tsc && npx mcp-build",
     "watch": "tsc --watch",
     "start": "node dist/index.js",
     "test": "node --no-warnings --experimental-vm-modules ./node_modules/jest/bin/jest.js",
@@ -38,12 +37,14 @@
     "fresh": "npm run reset && npm cache verify && npm install && npm run build && npm test"
   },
   "dependencies": {
-    "@camptocamp/ogc-client": "^1.3.0",
-    "@ignfab/gpf-schema-store": "^0.1.1",
+    "@ignfab/gpf-schema-store": "^0.1.5",
+    "@rgrove/parse-xml": "^4.2.0",
+    "@turf/distance": "^7.3.4",
+    "@turf/helpers": "^7.3.4",
     "https-proxy-agent": "^7.0.6",
     "jsts": "^2.12.1",
     "lodash": "^4.17.21",
-    "mcp-framework": "^0.2.21",
+    "mcp-framework": "^0.2.22",
     "node-fetch": "^3.3.2",
     "winston": "^3.18.3",
     "zod": "^3.25.76"

package/dist/resources/WfsCqlFilterResource.d.ts

@@ -1,10 +0,0 @@
-import { MCPResource, ResourceContent } from "mcp-framework";
-declare class WfsCqlFilterResource extends MCPResource {
-    uri: string;
-    name: string;
-    description: string;
-    mimeType: string;
-    protected title: string;
-    read(): Promise<ResourceContent[]>;
-}
-export default WfsCqlFilterResource;

package/dist/resources/WfsCqlFilterResource.js

@@ -1,23 +0,0 @@
-import { MCPResource } from "mcp-framework";
-import { readFile } from "fs/promises";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-class WfsCqlFilterResource extends MCPResource {
-    uri = "geocontext://wfs-cql-filter";
-    name = "geocontext-wfs-cql-filter";
-    description = "Aide-mémoire pour construire des cql_filter GeoServer utilisables avec les tools WFS.";
-    mimeType = "text/markdown";
-    title = "Cheatsheet cql_filter";
-    async read() {
-        const text = await readFile(join(dirname(fileURLToPath(import.meta.url)), "content", "wfs-cql-filter.md"), "utf-8");
-        return [
-            {
-                uri: this.uri,
-                mimeType: this.mimeType,
-                text,
-            },
-        ];
-    }
-}
-export default WfsCqlFilterResource;
-//# sourceMappingURL=WfsCqlFilterResource.js.map

package/dist/resources/WfsCqlFilterResource.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WfsCqlFilterResource.js","sourceRoot":"","sources":["../../src/resources/WfsCqlFilterResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,oBAAqB,SAAQ,WAAW;IAC5C,GAAG,GAAG,6BAA6B,CAAC;IACpC,IAAI,GAAG,2BAA2B,CAAC;IACnC,WAAW,GAAG,uFAAuF,CAAC;IACtG,QAAQ,GAAG,eAAe,CAAC;IACjB,KAAK,GAAG,uBAAuB,CAAC;IAE1C,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,mBAAmB,CAAC,EAC7E,OAAO,CACR,CAAC;QAEF,OAAO;YACL;gBACE,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI;aACL;SACF,CAAC;IACJ,CAAC;CACF;AAED,eAAe,oBAAoB,CAAC"}

package/dist/resources/content/wfs-cql-filter.md

@@ -1,215 +0,0 @@
-# cql_filter GeoServer
-
-Utiliser `cql_filter` avec `gpf_wfs_get_features` pour restreindre les objets renvoyés.
-
-## Checklist
-
-Avant d'écrire un `cql_filter` :
-
-1. Appeler `gpf_wfs_describe_type`.
-2. Identifier le champ géométrique.
-3. Lire son `defaultCrs`.
-4. Si `defaultCrs = EPSG:4326`, écrire les coordonnées en `lat lon`.
-5. Si `defaultCrs = EPSG:2154`, écrire les coordonnées en `x y`.
-6. Fournir `cql_filter` en texte brut, sans URL encoding manuel.
-7. Utiliser `cql_filter` pour choisir quels objets sont renvoyés, et `property_names` pour choisir quelles propriétés de ces objets sont renvoyées.
-
-## Champ géométrique
-
-Règles pratiques :
-
-- Un type WFS expose en pratique au plus un seul champ géométrique.
-- Le repère le plus fiable est la présence de `defaultCrs`.
-- Utiliser le nom exact du champ renvoyé par `gpf_wfs_describe_type`, par exemple `geom`, `geometrie` ou `the_geom`.
-- Le `type` du champ géométrique peut être `geometry`, `point`, `linestring`, `polygon`, `multipolygon`, etc.
-
-Exemple :
-
-```json
-{
-  "name": "geom",
-  "type": "multipolygon",
-  "defaultCrs": "EPSG:4326"
-}
-```
-
-## Ordre des coordonnées
-
-### `EPSG:4326`
-
-Utiliser `lat lon`.
-
-Exemples :
-
-- `POINT(48.8566 2.3522)`
-- `POLYGON((48.85 2.34,48.86 2.34,48.86 2.36,48.85 2.36,48.85 2.34))`
-
-### `EPSG:2154`
-
-Utiliser `x y`, c'est-à-dire `easting northing`.
-
-Exemples :
-
-- `POINT(700000 6600000)`
-- `POLYGON((700000 6600000,700500 6600000,700500 6600500,700000 6600500,700000 6600000))`
-
-## URL encoding
-
-Ne pas encoder manuellement `cql_filter`.
-
-Le tool `gpf_wfs_get_features` encode déjà les paramètres d'URL avec `URLSearchParams`.
-
-Conséquences :
-
-- écrire `cql_filter` sous forme lisible
-- ne pas remplacer les espaces par `%20`
-- ne pas encoder `(`, `)`, `,`, `'`
-- si `result_type = "url"`, l'URL renvoyée sera déjà encodée
-
-Correct :
-
-```text
-INTERSECTS(geom,POINT(48.8566 2.3522))
-```
-
-À éviter :
-
-```text
-INTERSECTS%28geom%2CPOINT%2848.8566%202.3522%29%29
-```
-
-## Templates
-
-### Égalité
-
-```text
-code_insee = '75056'
-```
-
-### Comparaison numérique
-
-```text
-population > 100000
-```
-
-### Liste de valeurs
-
-```text
-nature IN ('route', 'chemin', 'sentier')
-```
-
-### Intervalle
-
-```text
-surface BETWEEN 1000 AND 5000
-```
-
-### LIKE
-
-```text
-nom LIKE 'Saint-%'
-```
-
-### INTERSECTS avec point en `EPSG:4326`
-
-```text
-INTERSECTS(geom,POINT(48.8566 2.3522))
-```
-
-### INTERSECTS avec point en `EPSG:2154`
-
-```text
-INTERSECTS(geom,POINT(700000 6600000))
-```
-
-### BBOX recommandé en `EPSG:4326`
-
-```text
-BBOX(geom, 48.80, 2.20, 48.90, 2.45)
-```
-
-### BBOX recommandé en `EPSG:2154`
-
-```text
-BBOX(geom, 699000, 6599000, 701000, 6601000)
-```
-
-### POLYGON en `EPSG:4326`
-
-```text
-INTERSECTS(geom,POLYGON((48.85 2.34,48.86 2.34,48.86 2.36,48.85 2.36,48.85 2.34)))
-```
-
-### POLYGON en `EPSG:2154`
-
-```text
-INTERSECTS(geom,POLYGON((700000 6600000,700500 6600000,700500 6600500,700000 6600500,700000 6600000)))
-```
-
-### Distance
-
-```text
-DWITHIN(geom,POINT(48.8566 2.3522),100,meters)
-```
-
-### Attributaire + spatial
-
-```text
-type = 'hopital' AND BBOX(geom, 48.80, 2.20, 48.90, 2.45)
-```
-
-## Filtres attributaires
-
-Exemples fréquents :
-
-- `statut = 'actif'`
-- `population >= 100000`
-- `surface < 5000`
-- `etat <> 'supprime'`
-- `code_insee IN ('75056', '69123', '31555')`
-- `population BETWEEN 100000 AND 500000`
-- `nom LIKE '%Paris%'`
-- `nature = 'route' AND importance >= 3`
-
-## Filtres spatiaux
-
-Bon premier choix pour un LLM :
-
-- préférer `BBOX(...)` quand un rectangle suffit
-- utiliser `INTERSECTS(...)` pour un point ou un polygone explicite
-- utiliser `DWITHIN(...)` pour une recherche par distance
-
-Exemples :
-
-- `BBOX(geom, 48.80, 2.20, 48.90, 2.45)`
-- `INTERSECTS(geom,POINT(48.8566 2.3522))`
-- `INTERSECTS(geom,POLYGON((48.85 2.34,48.86 2.34,48.86 2.36,48.85 2.36,48.85 2.34)))`
-- `DWITHIN(geom,POINT(48.8566 2.3522),100,meters)`
-
-## Erreurs à éviter
-
-- Inventer un nom de propriété.
-- Oublier d'appeler `gpf_wfs_describe_type`.
-- Confondre `lat lon` et `lon lat` en `EPSG:4326`.
-- Utiliser `x y` sur un type en `EPSG:4326`.
-- Pré-encoder `cql_filter`.
-- Utiliser `cql_filter` pour limiter les champs au lieu de `property_names`.
-- Construire un `POLYGON` non fermé.
-
-## Bonnes pratiques pour un LLM
-
-- Commencer par un filtre simple.
-- Préférer `BBOX(...)` si la zone de recherche est rectangulaire.
-- Vérifier systématiquement `defaultCrs` avant toute géométrie.
-- Utiliser des apostrophes pour les chaînes.
-- Garder le filtre lisible et minimal.
-- Ajouter ensuite les conditions supplémentaires si nécessaire.
-
-## Procédure recommandée
-
-1. Trouver le type avec `gpf_wfs_search_types`.
-2. Lire les propriétés avec `gpf_wfs_describe_type`.
-3. Identifier le champ géométrique via `defaultCrs`.
-4. Choisir l'ordre des coordonnées selon le CRS.
-5. Écrire un premier filtre simple.
-6. Ajouter ensuite les contraintes attributaires ou spatiales.

package/dist/tools/GpfWfsListTypesTool.d.ts

@@ -1,22 +0,0 @@
-import { MCPTool } from "mcp-framework";
-import { z } from "zod";
-declare const gpfWfsListTypesInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-type GpfWfsListTypesInput = z.infer<typeof gpfWfsListTypesInputSchema>;
-declare class GpfWfsListTypesTool extends MCPTool<GpfWfsListTypesInput> {
-    name: string;
-    title: string;
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-    description: string;
-    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-    execute(input: GpfWfsListTypesInput): Promise<{
-        id: string;
-        title: string;
-        description: string;
-    }[]>;
-}
-export default GpfWfsListTypesTool;

package/dist/tools/GpfWfsListTypesTool.js

@@ -1,26 +0,0 @@
-import { MCPTool } from "mcp-framework";
-import { z } from "zod";
-import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "../helpers/toolAnnotations.js";
-import { wfsClient } from "../gpf/wfs.js";
-const gpfWfsListTypesInputSchema = z.object({});
-class GpfWfsListTypesTool extends MCPTool {
-    name = "gpf_wfs_list_types";
-    title = "Liste complète des types WFS";
-    annotations = READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS;
-    description = [
-        "Renvoie la liste complète des types WFS de la Géoplateforme (GPF).",
-        "Utiliser ce tool pour un inventaire exhaustif ou une exploration globale du catalogue.",
-        "Pour trouver rapidement un type pertinent à partir de mots-clés, utiliser de préférence gpf_wfs_search_types.",
-    ].join("\r\n");
-    schema = gpfWfsListTypesInputSchema;
-    async execute(input) {
-        const featureTypes = await wfsClient.getFeatureTypes();
-        return featureTypes.map((featureType) => ({
-            id: featureType.id,
-            title: featureType.title,
-            description: featureType.description,
-        }));
-    }
-}
-export default GpfWfsListTypesTool;
-//# sourceMappingURL=GpfWfsListTypesTool.js.map

package/dist/tools/GpfWfsListTypesTool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GpfWfsListTypesTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsListTypesTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAIhD,MAAM,mBAAoB,SAAQ,OAA6B;IAC7D,IAAI,GAAG,oBAAoB,CAAC;IAC5B,KAAK,GAAG,8BAA8B,CAAC;IACvC,WAAW,GAAG,qCAAqC,CAAC;IACpD,WAAW,GAAG;QACZ,oEAAoE;QACpE,wFAAwF;QACxF,+GAA+G;KAChH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,MAAM,GAAG,0BAA0B,CAAC;IAEpC,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;QACvD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACxC,EAAE,EAAE,WAAW,CAAC,EAAE;YAClB,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,WAAW,EAAE,WAAW,CAAC,WAAW;SACrC,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,eAAe,mBAAmB,CAAC"}