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

Related MCP server: geopera-mcp

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.

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.

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

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