@ignfab/geocontext 0.8.0

package/dist/tools/GpfWfsGetFeaturesTool.js

@@ -0,0 +1,89 @@
+import { logger, MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { GPF_WFS_URL } from "../gpf/wfs.js";
+import { fetchJSON } from "../helpers/http.js";
+class GpfWfsGetFeaturesTool extends MCPTool {
+    name = "gpf_wfs_get_features";
+    description = "Permet de récupérer les objets pour un type WFS.";
+    schema = {
+        typename: {
+            type: z.string(),
+            description: "Le nom du type (ex : BDTOPO_V3:batiment). Important : Utiliser gpf_wfs_search_types pour trouver les types disponibles."
+        },
+        property_names: {
+            type: z.string().optional(),
+            description: 'La liste des propriétés séparées par des virgules (ex : "code_insee,nom_officiel,geometrie"). NB : adapter geometrie avec geometryName au niveau du type WFS. '
+        },
+        sort_by: {
+            type: z.string().optional(),
+            description: 'Trier selon une propriété (syntaxe : field1 [A|D], field2 [A|D], ... , fieldN [A|D])'
+        },
+        count: {
+            type: z.number().optional(),
+            description: "Le nombre d'objets à récupérer (ex : 10)"
+        },
+        cql_filter: {
+            type: z.string().optional(),
+            description: "Le filtre au format cql_filter de GeoServer. ATTENTION : il faut permuter les coordonnées pour EPSG:4326 (ex : 'DWITHIN(geom,Point(${lat} ${lon}),10,meters)')"
+        },
+        result_type: {
+            type: z.enum(['results', 'hits', 'url']).optional(),
+            description: [
+                "Type de résultat : ",
+                "- 'results' pour les données complètes (défaut)",
+                "- 'hits' pour le comptage uniquement",
+                "- 'url' pour récupérer l'URL de la requête (ex : affichage des données côté client dans une carte)"
+            ].join("\r\n")
+        }
+    };
+    async execute(input) {
+        const params = {
+            service: 'WFS',
+            request: 'GetFeature',
+            typeName: input.typename,
+            outputFormat: 'application/json'
+        };
+        // Only add optional parameters if they are defined
+        if (input.cql_filter) {
+            params.cql_filter = input.cql_filter;
+        }
+        if (input.count) {
+            params.count = input.count;
+        }
+        if (input.sort_by) {
+            params.sortBy = input.sort_by;
+        }
+        if (input.property_names && input.property_names.length > 0) {
+            params.propertyName = input.property_names;
+        }
+        // Si result_type est 'hits', on utilise count=1 pour récupérer juste le totalFeatures
+        if (input.result_type === 'hits') {
+            params.count = 1;
+            // On n'a pas besoin des propriétés détaillées pour un comptage
+            delete params.propertyName;
+        }
+        const url = `${GPF_WFS_URL}?` + new URLSearchParams(params).toString();
+        logger.info(`[gpf_wfs_get_features] ${url}`);
+        if (input.result_type === 'url') {
+            return url;
+        }
+        try {
+            const featureCollection = await fetchJSON(url);
+            // Si result_type est 'hits', on retourne juste le comptage
+            if (input.result_type === 'hits') {
+                return featureCollection.totalFeatures;
+            }
+            return featureCollection;
+        }
+        catch (e) {
+            logger.error(`[gpf_wfs_get_features] ${e}`);
+            return {
+                type: "error",
+                message: "Une erreur est survenue lors de la récupération des objets (utiliser gpf_wfs_describe_type pour lister les types disponibles avant d'appeler gpf_wfs_get_features)",
+                details: `${e}`
+            };
+        }
+    }
+}
+export default GpfWfsGetFeaturesTool;
+//# sourceMappingURL=GpfWfsGetFeaturesTool.js.map

package/dist/tools/GpfWfsGetFeaturesTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GpfWfsGetFeaturesTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsGetFeaturesTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAW/C,MAAM,qBAAsB,SAAQ,OAA+B;IACjE,IAAI,GAAG,sBAAsB,CAAC;IAC9B,WAAW,GAAG,kDAAkD,CAAC;IAEjE,MAAM,GAAG;QACP,QAAQ,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,yHAAyH;SACvI;QACD,cAAc,EAAE;YACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,WAAW,EAAE,gKAAgK;SAC9K;QACD,OAAO,EAAE;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,WAAW,EAAE,sFAAsF;SACpG;QACD,KAAK,EAAE;YACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,WAAW,EAAE,0CAA0C;SACxD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,WAAW,EAAE,gKAAgK;SAC9K;QACD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;YACnD,WAAW,EAAE;gBACX,qBAAqB;gBACrB,iDAAiD;gBACjD,sCAAsC;gBACtC,oGAAoG;aACrG,CAAC,IAAI,CAAC,MAAM,CAAC;SACf;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAA6B;QACzC,MAAM,MAAM,GAAS;YACnB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,kBAAkB;SACjC,CAAC;QAEF,mDAAmD;QACnD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACvC,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC7B,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;QAChC,CAAC;QACD,IAAI,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,cAAc,CAAC;QAC7C,CAAC;QAED,sFAAsF;QACtF,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;YACjC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;YACjB,+DAA+D;YAC/D,OAAO,MAAM,CAAC,YAAY,CAAC;QAC7B,CAAC;QAGD,MAAM,GAAG,GAAG,GAAG,WAAW,GAAG,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;QAE7C,IAAK,KAAK,CAAC,WAAW,KAAK,KAAK,EAAG,CAAC;YAClC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YAE/C,2DAA2D;YAC3D,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;gBACjC,OAAO,iBAAiB,CAAC,aAAa,CAAC;YACzC,CAAC;YAED,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QAAA,OAAM,CAAC,EAAC,CAAC;YACR,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC;YAC5C,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,oKAAoK;gBAC7K,OAAO,EAAE,GAAG,CAAC,EAAE;aAChB,CAAA;QACH,CAAC;IACH,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/tools/GpfWfsListTypesTool.d.ts

@@ -0,0 +1,10 @@
+import { MCPTool } from "mcp-framework";
+interface WfsTypesInput {
+}
+declare class GpfWfsListTypesTools extends MCPTool<WfsTypesInput> {
+    name: string;
+    description: string;
+    schema: {};
+    execute(input: WfsTypesInput): Promise<string[]>;
+}
+export default GpfWfsListTypesTools;

package/dist/tools/GpfWfsListTypesTool.js

@@ -0,0 +1,18 @@
+import { MCPTool } from "mcp-framework";
+import { wfsClient } from "../gpf/wfs.js";
+class GpfWfsListTypesTools extends MCPTool {
+    name = "gpf_wfs_list_types";
+    description = [
+        "Renvoie la liste des types WFS de la Géoplateforme (GPF). ATTENTION :",
+        "- Il y a plus de 700 résultats possibles",
+        "- Il est conseillé d'utiliser de préférence gpf_wfs_search_types pour filtrer les résultats.",
+    ].join("\r\n");
+    schema = {};
+    async execute(input) {
+        const featureTypes = await wfsClient.getFeatureTypes();
+        const featureTypeNames = featureTypes.map((featureType) => featureType.name);
+        return featureTypeNames;
+    }
+}
+export default GpfWfsListTypesTools;
+//# sourceMappingURL=GpfWfsListTypesTool.js.map

package/dist/tools/GpfWfsListTypesTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GpfWfsListTypesTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsListTypesTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK1C,MAAM,oBAAqB,SAAQ,OAAsB;IACvD,IAAI,GAAG,oBAAoB,CAAC;IAC5B,WAAW,GAAG;QACZ,uEAAuE;QACvE,0CAA0C;QAC1C,8FAA8F;KAC/F,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,MAAM,GAAG,EAER,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;QACvD,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF;AAED,eAAe,oBAAoB,CAAC"}

package/dist/tools/GpfWfsSearchTypesTool.d.ts

@@ -0,0 +1,22 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+interface GpfWfsSearchTypesInput {
+    query: string;
+    max_results: number;
+}
+declare class GpfWfsSearchTypesTool extends MCPTool<GpfWfsSearchTypesInput> {
+    name: string;
+    description: string;
+    schema: {
+        query: {
+            type: z.ZodString;
+            description: string;
+        };
+        max_results: {
+            type: z.ZodOptional<z.ZodNumber>;
+            description: string;
+        };
+    };
+    execute(input: GpfWfsSearchTypesInput): Promise<string[]>;
+}
+export default GpfWfsSearchTypesTool;

package/dist/tools/GpfWfsSearchTypesTool.js

@@ -0,0 +1,31 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { wfsClient } from "../gpf/wfs.js";
+class GpfWfsSearchTypesTool extends MCPTool {
+    name = "gpf_wfs_search_types";
+    description = [
+        "Recherche par mot clé dans la liste des types WFS de la Géoplateforme (GPF). Remarques :",
+        "- La recherche est une recherche textuelle simple (mini-search).",
+        "- Un LLM peut enrichir la recherche avec des mots clés supplémentaires.",
+        "- La recherche est limitée par défaut à 10 résultats",
+        "- Le paramètre max_results permet de changer le nombre de résultats (par exemple pour trouver toutes les tables BDTOPO ou toutes les tables communes)",
+    ].join("\r\n");
+    schema = {
+        query: {
+            type: z.string(),
+            description: "La requête de recherche",
+        },
+        max_results: {
+            type: z.number().optional(),
+            description: "Le nombre de résultats (10 par défaut)",
+        },
+    };
+    async execute(input) {
+        const maxResults = input.max_results || 10;
+        const featureTypes = await wfsClient.searchFeatureTypes(input.query, maxResults);
+        const featureTypeNames = featureTypes.map((featureType) => featureType.name);
+        return featureTypeNames;
+    }
+}
+export default GpfWfsSearchTypesTool;
+//# sourceMappingURL=GpfWfsSearchTypesTool.js.map

package/dist/tools/GpfWfsSearchTypesTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GpfWfsSearchTypesTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsSearchTypesTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO1C,MAAM,qBAAsB,SAAQ,OAA+B;IACjE,IAAI,GAAG,sBAAsB,CAAC;IAC9B,WAAW,GAAG;QACZ,0FAA0F;QAC1F,kEAAkE;QAClE,yEAAyE;QACzE,sDAAsD;QACtD,uJAAuJ;KACxJ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,MAAM,GAAG;QACP,KAAK,EAAE;YACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,yBAAyB;SACvC;QACD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,WAAW,EAAE,wCAAwC;SACtD;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAA6B;QACzC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAC3C,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACjF,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/tools/UrbanismeTool.d.ts

@@ -0,0 +1,22 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+interface UrbanismeInput {
+    lon: number;
+    lat: number;
+}
+declare class UrbanismeTool extends MCPTool<UrbanismeInput> {
+    name: string;
+    description: string;
+    schema: {
+        lon: {
+            type: z.ZodNumber;
+            description: string;
+        };
+        lat: {
+            type: z.ZodNumber;
+            description: string;
+        };
+    };
+    execute(input: UrbanismeInput): Promise<any>;
+}
+export default UrbanismeTool;

package/dist/tools/UrbanismeTool.js

@@ -0,0 +1,23 @@
+import { logger, MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { getUrbanisme, URBANISME_SOURCE } from "../gpf/urbanisme.js";
+class UrbanismeTool extends MCPTool {
+    name = "urbanisme";
+    description = `Renvoie les informations du document d'urbanisme (PLU, PLUi, POS, CC, PSMV) pour une position donnée par sa longitude et sa latitude (source: ${URBANISME_SOURCE}).`;
+    schema = {
+        lon: {
+            type: z.number(),
+            description: "La longitude du point",
+        },
+        lat: {
+            type: z.number(),
+            description: "La latitude du point",
+        },
+    };
+    async execute(input) {
+        logger.info(`urbanisme(${input.lon},${input.lat})...`);
+        return getUrbanisme(input.lon, input.lat);
+    }
+}
+export default UrbanismeTool;
+//# sourceMappingURL=UrbanismeTool.js.map

package/dist/tools/UrbanismeTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanismeTool.js","sourceRoot":"","sources":["../../src/tools/UrbanismeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAOrE,MAAM,aAAc,SAAQ,OAAuB;IACjD,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,iJAAiJ,gBAAgB,IAAI,CAAC;IAEpL,MAAM,GAAG;QACP,GAAG,EAAE;YACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,uBAAuB;SACrC;QACD,GAAG,EAAE;YACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,sBAAsB;SACpC;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAqB;QACjC,MAAM,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC;QACvD,OAAO,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,eAAe,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ignfab/geocontext",
+  "version": "0.8.0",
+  "description": "An experimental MCP server providing spatial context for LLM.",
+  "type": "module",
+  "bin": {
+    "geocontext": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ignfab/geocontext.git"
+  },
+  "keywords": [
+    "llm",
+    "rag",
+    "action",
+    "spatial",
+    "context"
+  ],
+  "author": "MBorne <mborne@users.noreply.github.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ignfab/geocontext/issues"
+  },
+  "homepage": "https://github.com/ignfab/geocontext#readme",
+  "scripts": {
+    "build": "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",
+    "coverage": "node --no-warnings --experimental-vm-modules ./node_modules/jest/bin/jest.js --coverage"
+  },
+  "dependencies": {
+    "@camptocamp/ogc-client": "^1.3.0",
+    "https-proxy-agent": "^7.0.6",
+    "jsts": "^2.12.1",
+    "mcp-framework": "^0.2.15",
+    "minisearch": "^7.2.0",
+    "node-fetch": "^3.3.2",
+    "winston": "^3.17.0",
+    "lodash": "^4.17.21"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/geojson": "^7946.0.16",
+    "@types/jest": "^30.0.0",
+    "@types/lodash": "^4.17.20",
+    "@types/node": "^24.5.2",
+    "@types/supertest": "^6.0.3",
+    "geojson": "^0.5.0",
+    "jest": "^30.2.0",
+    "supertest": "^7.1.4",
+    "ts-jest": "^29.4.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  }
+}