geonetwork-mcp

Serveur MCP pour la découverte et l'accès aux données d'un catalogue GeoNetwork 4.x.

Permet à un assistant IA de rechercher des fiches de métadonnées, consulter leurs détails et découvrir les services (WMS, WFS, téléchargements...) référencés dans le catalogue.

Les réponses de l'API GeoNetwork sont converties en CatalogRecord (modèle pivot de geonetwork-ui) via la librairie @geonetwork-ui/metadata-converter.

Installation

npm install
npm run build

Configuration MCP

{
  "mcpServers": {
    "geonetwork": {
      "command": "node",
      "args": ["/chemin/vers/geonetwork_mcp/dist/index.js"],
      "env": {
        "GEONETWORK_URL": "https://example.org/geonetwork"
      }
    }
  }
}

L'URL peut aussi être passée en argument CLI :

node dist/index.js https://example.org/geonetwork

Tools

search_records

Rechercher des fiches de métadonnées dans le catalogue.

Paramètre	Type	Description
query	string	Texte libre (titre, résumé, mots-clés)
type	string	Type de ressource : dataset, series, service, map
organization	string	Filtrer par nom d'organisation
bbox	string	Emprise géographique west,south,east,north (EPSG:4326)
from	number	Index de départ pour la pagination (défaut: 0)
size	number	Nombre de résultats (défaut: 20, max: 100)

get_record

Consulter les métadonnées complètes d'une fiche : titre, résumé, mots-clés, contacts, contraintes, généalogie, emprise spatiale et temporelle, catégories thématiques.

Paramètre	Type	Description
uuid	string	UUID de la fiche

get_record_resources

Lister les ressources associées à une fiche, groupées par usage (classification via getUsagesForLink de geonetwork-ui) :

• Services / API — WFS, OGC Features, ESRI REST...
• Services cartographiques — WMS, WMTS, TMS
• Données géographiques — GeoJSON, Shapefile, GeoPackage...
• Données tabulaires — CSV, Excel, JSON
• Téléchargements — fichiers téléchargeables
• Autres liens — pages d'information, documentation

Paramètre	Type	Description
uuid	string	UUID de la fiche

Architecture

src/
├── index.ts                     # Entry point (stdio transport)
├── server.ts                    # McpServer + enregistrement des tools
├── api/
│   └── client.ts                # GeoNetworkClient (wrapper sur la lib)
└── tools/
    ├── search-records.ts
    ├── get-record.ts
    └── get-record-resources.ts
lib/
└── metadata-converter/          # @geonetwork-ui/metadata-converter
    └── ...                      # Modèle CatalogRecord, converter GN4, link utilities

Développement

npm run dev          # tsc --watch
npm run test         # vitest

Prérequis

• Node.js >= 18
• Un catalogue GeoNetwork 4.x accessible en réseau