MCP SHOM Wrecks — Base d'épaves SHOM pour Claude Code

English below

Serveur MCP qui expose la base d'épaves du SHOM (Service Hydrographique et Océanographique de la Marine) — 4 796+ épaves sur l'ensemble des eaux françaises — à des assistants IA comme Claude Code.

Conçu pour la planification de plongée, la recherche nautique et l'exploration historique.

Ce que ça fait

Interrogez la base officielle d'épaves de la Marine française en langage naturel :

"Cherche l'épave du Courbet"
"Quelles épaves sont à moins de 5 milles de Ouistreham ?"
"Liste les épaves entre 49.1°N et 49.5°N, de -1°W à 0°E"

Le serveur traduit ces requêtes en appels WFS vers l'API SHOM et renvoie les résultats formatés.

Les 4 outils

Détail des outils

search_wreck_by_name

Recherche par nom avec correspondance partielle insensible à la casse.

get_nearby_wrecks

Trouve les épaves proches d'une position GPS. Idéal pour la planification de plongée.

search_wrecks_bbox

Recherche dans une zone rectangulaire (bounding box).

get_wreck_details

Fiche complète d'une épave par son identifiant SHOM.

Champs de données

Chaque épave de la base SHOM peut contenir :

Source de données

Toutes les données proviennent de l'API WFS ouverte du SHOM :

Plus d'infos : data.shom.fr

Prérequis

• Node.js >= 18
• npm
• Claude Code (ou tout client MCP)

Installation

# Cloner le repo
git clone https://github.com/dorian-erkens/mcp-shom-wrecks.git
cd mcp-shom-wrecks

# Installer et compiler
npm install
npm run build

Important : le dossier dist/ n'est pas commité — il faut lancer npm run build avant de pouvoir démarrer le serveur.

Configuration dans Claude Code

Ajouter dans ~/.claude/settings.json :

{
  "mcpServers": {
    "shom-wrecks": {
      "command": "node",
      "args": ["/chemin/vers/mcp-shom-wrecks/dist/index.js"]
    }
  }
}

Puis relancer Claude Code. Les 4 outils seront disponibles automatiquement.

Lancement autonome

npm start

Le serveur communique via stdin/stdout en JSON-RPC (protocole MCP). Ce n'est pas un serveur HTTP — Claude Code (ou tout client MCP) le lance comme processus enfant.

Commandes

Exemples de requêtes

Une fois configuré, posez vos questions en langage naturel :

"Cherche l'épave du Courbet"
  → search_wreck_by_name(name: "Courbet")

"Quelles épaves sont à moins de 5 milles de Ouistreham ?"
  → get_nearby_wrecks(lat: 49.28, lon: -0.2467, radius_nm: 5)

"Liste les épaves entre 49.1°N et 49.5°N, de -1°W à 0°E"
  → search_wrecks_bbox(min_lat: 49.1, max_lat: 49.5, min_lon: -1.0, max_lon: 0)

"Donne-moi les détails de l'épave wrecks.1234"
  → get_wreck_details(id: "wrecks.1234")

"What wrecks are near the D-Day beaches?"
  → get_nearby_wrecks with appropriate coordinates

Fonctionne en français ou en anglais — les paramètres des outils sont les mêmes.

Stack technique

• TypeScript — mode strict
• @modelcontextprotocol/sdk — framework serveur MCP
• zod — validation des entrées
• SHOM WFS API — source de données (requêtes live, pas de base locale)

Comment ça marche

1. Le serveur MCP démarre sur stdio et enregistre 4 outils
2. À chaque appel, il construit une requête WFS GetFeature avec les filtres appropriés (BBOX, CQL_FILTER ou FEATUREID)
3. L'API SHOM renvoie des features GeoJSON
4. Les résultats sont parsés, enrichis (calculs distance/relèvement pour les recherches de proximité) et formatés en markdown

Les recherches par nom utilisent des filtres CQL ILIKE côté serveur, avec un fallback côté client si le filtre n'est pas supporté. Les calculs de distance utilisent la navigation plane (suffisant pour les portées typiques de planification de plongée).

Utilisé par

• Dive Director — Assistant DP pour Claude Code (8 agents, /plan-dive)
• Dive Director App — Web app (FastAPI + React) avec carte des épaves, chat IA et inspector panel

Licence

MIT

Auteur

Dorian Erkens

English

mcp-shom-wrecks is an MCP (Model Context Protocol) server that exposes the SHOM (French Naval Hydrographic Service) wreck database — 4,796+ shipwrecks across all French waters — to AI assistants like Claude Code.

Designed for dive planning, nautical research, and historical exploration.

4 tools available

Quick start

git clone https://github.com/dorian-erkens/mcp-shom-wrecks.git
cd mcp-shom-wrecks
npm install && npm run build

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "shom-wrecks": {
      "command": "node",
      "args": ["/path/to/mcp-shom-wrecks/dist/index.js"]
    }
  }
}

Then restart Claude Code. The 4 tools are available automatically — just ask in natural language:

• "Search for the Courbet wreck" → search_wreck_by_name
• "What wrecks are within 5 miles of Ouistreham?" → get_nearby_wrecks
• "What wrecks are near the D-Day beaches?" → get_nearby_wrecks
• "List wrecks between 49.1°N–49.5°N, -1°W–0°E" → search_wrecks_bbox
• "Give me details on wreck wrecks.1234" → get_wreck_details

Works in French or English — the data source (SHOM) covers all French metropolitan and overseas waters.

Data source

All data comes from the SHOM open data WFS API (WFS 1.1.0, no authentication required, EPSG:4326). Live queries — no local database needed.

Used by

• Dive Director — AI-powered Dive Director assistant for Claude Code (8 agents, /plan-dive)
• Dive Director App — Web app (FastAPI + React) with wreck map, AI chat, and inspector panel