Aller au contenu principal

Serveur MCP Infoparcelle

License: MIT TypeScript MCP

Le serveur MCP (Model Context Protocol) Infoparcelle permet aux LLMs (Large Language Models) comme Claude ou ChatGPT d'interagir directement avec l'API Infoparcelle pour accéder aux données foncières, cadastrales et immobilières françaises.

Vue d'ensemble​

Le MCP Infoparcelle est un connecteur qui permet aux assistants IA d'utiliser les 14 outils de l'API Infoparcelle de manière transparente. Il gère automatiquement l'authentification, les requêtes API et le formatage des réponses.

Données disponibles​

  • Géocodage : Recherche d'adresses, géocodage inversé, coordonnées GPS
  • Parcelles cadastrales : Recherche avancée, superficies, contours, propriétaires
  • Municipalités : Informations sur les communes françaises
  • Transactions immobilières (DVF) : Prix de vente réels, historique des transactions
  • Diagnostics énergétiques (DPE) : Classes énergétiques, consommations, émissions GES
  • Plans Locaux d'Urbanisme (PLU) : Zones d'urbanisme, règles de construction, documents officiels
  • Permis de construire : Autorisations d'urbanisme, projets de construction
  • Propriétaires : Personnes morales propriétaires de biens immobiliers (entreprises, organismes)
  • Copropriétés : Registre national des copropriétés, syndics, lots
  • Occupants : Établissements et entreprises présents sur les parcelles (SIRENE)

Deux méthodes d'utilisation​

Option 1 : MCP Hébergé (Recommandée)​

Utilisez le serveur MCP hébergé par Infoparcelle, sans installation nécessaire.

Configuration requise​

  1. Créer un client OAuth2 sur app.infoparcelle.fr/compte/api :

    • Nom du client : MCP Infoparcelle (ou votre choix)
    • URL de callback : https://mcp.infoparcelle.fr/oauth/callback
    • Récupérez le Client ID et Client Secret

  2. Configurer dans Claude Desktop :

    • Ouvrez Claude > Paramètres > Connecteurs
    • Cliquez sur "Ajouter un connecteur personnalisé"
    • Remplissez :
      • Nom : Infoparcelle MCP
      • URL : https://mcp.infoparcelle.fr/mcp
      • OAuth Client ID : Votre Client ID
      • OAuth Client Secret : Votre Client Secret
    • Cliquez sur "Se connecter"

  3. S'authentifier :

    • Une page de connexion s'ouvre dans votre navigateur
    • Connectez-vous avec vos identifiants Infoparcelle
    • Autorisez l'accès

Avantages​

✅ Aucune installation requise ✅ Toujours à jour avec la dernière version ✅ Haute disponibilité garantie ✅ Configuration simplifiée ✅ Support OAuth2 complet

Option 2 : Auto-hébergé​

Hébergez votre propre instance du serveur MCP pour un contrôle total.

Installation​

Prérequis :

  • Node.js >= 18.0.0
  • npm ou yarn

Installation des dépendances :

git clone https://github.com/Rootsud/Infoparcelle-MCP.git
cd Infoparcelle-MCP
npm install
npm run build

Configuration avec clé API​

  1. Créer une clé API sur app.infoparcelle.fr/compte/api

  2. Configurer Claude Desktop :

    Ajoutez dans votre claude_desktop_config.json :

    Emplacement du fichier :

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

    Configuration :

    {
      "mcpServers": {
        "infoparcelle": {
          "command": "node",
          "args": ["/chemin/absolu/vers/Infoparcelle-MCP/build/index.js"],
          "env": {
            "INFOPARCELLE_API_KEY": "votre_cle_api"
          }
        }
      }
    }

  3. Redémarrer Claude Desktop

Configuration avec Email/Mot de passe​

Si vous préférez utiliser vos identifiants au lieu d'une clé API :

{
  "mcpServers": {
    "infoparcelle": {
      "command": "node",
      "args": ["/chemin/absolu/vers/Infoparcelle-MCP/build/index.js"],
      "env": {
        "INFOPARCELLE_EMAIL": "votre.email@example.com",
        "INFOPARCELLE_PASSWORD": "votre_mot_de_passe"
      }
    }
  }
}
Important

Le token est automatiquement renouvelé quand il expire. Assurez-vous que votre email est vérifié et votre compte actif.

Mode HTTP (optionnel)​

Pour exposer le MCP via HTTP (utile pour les déploiements distants) :

# Configuration
export MCP_TRANSPORT=http
export PORT=3000
export INFOPARCELLE_API_KEY="votre_cle_api"

# Démarrage
node build/index.js

Le serveur expose les endpoints suivants :

  • POST /mcp - Endpoint principal MCP
  • GET /mcp - Server-Sent Events (SSE)
  • GET /health - Health check
  • POST /oauth/token - OAuth token endpoint
  • GET /authorize - Page de connexion OAuth

Outils disponibles (14 outils)​

Géocodage (3 outils)​

Recherche d'adresses françaises par texte libre.

Exemple d'utilisation dans Claude :

Trouve-moi l'adresse exacte du 7 Rue de l'Élysée à Paris

infoparcelle_geocoder_ban​

Récupération d'une adresse par son identifiant BAN (Base Adresse Nationale).

infoparcelle_geocoder_coordinates​

Géocodage inversé : coordonnées GPS → parcelle cadastrale.

Exemple d'utilisation dans Claude :

Quelle est la parcelle cadastrale aux coordonnées 48.8566, 2.3522 ?

Parcelles cadastrales (3 outils)​

infoparcelle_parcelle_get​

Obtenir la fiche complète d'une parcelle par son identifiant.

Exemple d'utilisation dans Claude :

Donne-moi toutes les informations sur la parcelle cadastrale 750560000B0064

Recherche avancée de parcelles avec des dizaines de filtres.

Exemples d'utilisation dans Claude :

Trouve-moi des terrains constructibles de plus de 500m² à Paris

Recherche des maisons avec un bon DPE (A, B ou C) dans le département 92

Liste les parcelles avec bâtiment dans le 8ème arrondissement de Paris

infoparcelle_parcelle_preview​

Générer une prévisualisation SVG interactive d'une ou plusieurs parcelles.

Exemple d'utilisation dans Claude :

Génère une prévisualisation réaliste de la parcelle 750560000B0064 avec les mesures

Territoires (1 outil)​

Recherche de communes françaises.

Exemple d'utilisation dans Claude :

Trouve toutes les communes qui s'appellent Saint-Martin

Transactions immobilières - DVF (1 outil)​

Recherche de transactions immobilières avec prix réels.

Exemples d'utilisation dans Claude :

Montre-moi les transactions immobilières dans le 75008 depuis janvier 2023

Trouve les maisons vendues entre 300k€ et 500k€ dans le département 69

Quel est le prix moyen au m² des appartements vendus à Lyon en 2023 ?

Diagnostics énergétiques - DPE (1 outil)​

Recherche de diagnostics de performance énergétique.

Exemples d'utilisation dans Claude :

Combien y a-t-il de passoires énergétiques (F ou G) à Paris ?

Trouve les logements performants (A ou B) dans le département 69

Plans Locaux d'Urbanisme - PLU (1 outil)​

Recherche de zones PLU avec leurs documents officiels.

Exemples d'utilisation dans Claude :

Quelles sont les zones constructibles (U) à Paris ?

Montre-moi les zones agricoles dans le département 69

Autorisations d'urbanisme - Permis (1 outil)​

Recherche de permis de construire et autorisations d'urbanisme.

Exemples d'utilisation dans Claude :

Liste les permis de construire récents à Lyon depuis 2023

Trouve les projets avec création de plus de 5 logements dans le 75

Propriétaires (1 outil)​

Recherche de propriétaires personnes morales (entreprises, organismes publics).

Exemples d'utilisation dans Claude :

Trouve toutes les parcelles détenues par le SIREN 552032534

Liste les SCI propriétaires dans le 75008

Copropriétés (1 outil)​

Recherche de copropriétés immatriculées au registre national.

Exemples d'utilisation dans Claude :

Trouve les grandes copropriétés (plus de 50 lots) à Paris

Liste les copropriétés avec syndic bénévole dans le 69

Occupants (1 outil)​

Recherche d'établissements et entreprises présents sur les parcelles (données SIRENE).

Exemples d'utilisation dans Claude :

Liste les commerces actifs sur la parcelle 750560000B0064

Trouve tous les restaurants dans le 75008

Cas d'usage avec Claude​

Recherche immobilière​

"Trouve-moi des terrains constructibles de plus de 1000m²
dans le département 69 avec un bon accès (à moins de 500m d'une route)"

Analyse de marché​

"Analyse les transactions immobilières d'appartements à Lyon
au cours des 12 derniers mois et donne-moi le prix moyen au m²"

Étude énergétique​

"Combien y a-t-il de passoires énergétiques (DPE F ou G)
dans la commune de Marseille ?"

Investissement​

"Trouve des maisons avec un bon DPE (A, B ou C),
vendues récemment entre 200k€ et 400k€ dans le Rhône"

Étude d'urbanisme​

"Quelles sont les règles d'urbanisme applicables à cette parcelle ?
Montre-moi les zones PLU et les documents règlementaires"

Veille sur les projets de construction​

"Liste tous les permis de construire déposés dans ma commune
au cours des 6 derniers mois avec création de plus de 10 logements"

Analyse patrimoniale​

"Identifie toutes les parcelles détenues par cette SCI (SIREN 123456789)
dans le département 75 et donne-moi leur superficie totale"

Étude de copropriétés​

"Trouve les copropriétés de plus de 100 lots avec syndic professionnel
dans le 8ème arrondissement de Paris"

Analyse commerciale​

"Liste tous les commerces et restaurants actifs
sur les parcelles de cette rue (code postal 75008)"

Test avec MCP Inspector​

Pour tester le serveur MCP en mode local et explorer les outils disponibles :

npm run inspector

Cela lance le MCP Inspector qui vous permet de :

  • Lister tous les outils disponibles
  • Tester chaque outil avec des paramètres personnalisés
  • Voir les réponses formatées

Données et sources​

Les données proviennent de sources officielles françaises :

  • DGFiP : Données cadastrales, transactions (DVF), propriétaires
  • ADEME : Diagnostics de Performance Énergétique (DPE)
  • INSEE : Codes communes, populations, données SIRENE (occupants)
  • IGN : Géométries, contours
  • Géorisques : Risques naturels
  • ANAH : Registre national des copropriétés
  • Ministère de la Transition Écologique : Plans Locaux d'Urbanisme (PLU)
  • SITADEL : Permis de construire et autorisations d'urbanisme
  • INPI : Données des entreprises

Sécurité et confidentialité​

  • Authentification : Clé API ou OAuth2 selon la configuration
  • Rate limiting : 1200 requêtes/minute (20 req/sec)
  • Données publiques : Toutes les données sont publiques et officielles
  • Pas de stockage : Le serveur ne stocke aucune donnée utilisateur

Ressources​

Documentation​

Support​

Développement​

Structure du projet​

Infoparcelle-MCP/
├── src/
│   ├── index.ts                    # Point d'entrée du serveur MCP
│   ├── schemas/                    # Schémas de validation Zod
│   ├── tools/                      # Implémentation des 14 outils MCP
│   └── utils/                      # Utilitaires (API client, OAuth, etc.)
├── build/                          # Code TypeScript compilé
├── package.json                    # Dépendances et scripts npm
└── README.md                       # Documentation complète

Scripts disponibles​

# Compilation
npm run build

# Compilation en mode watch
npm run dev

# Test avec MCP Inspector
npm run inspector

# Nettoyage
npm run clean

Contribution​

Les contributions sont les bienvenues ! Pour contribuer :

  1. Forkez le projet sur GitHub
  2. Créez une branche pour votre fonctionnalité
  3. Committez vos changements
  4. Poussez vers la branche
  5. Ouvrez une Pull Request

Licence​

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

Recommandation

Le serveur MCP Infoparcelle est le moyen le plus simple et le plus puissant d'accéder aux données Infoparcelle via Claude, ChatGPT ou tout autre LLM compatible MCP. Nous recommandons l'utilisation du MCP hébergé pour une configuration simplifiée et une haute disponibilité.

Prochaines étapes​

  1. Choisissez votre méthode : MCP hébergé ou auto-hébergé
  2. Configurez votre client : Claude Desktop, ChatGPT, ou autre
  3. Obtenez vos identifiants : Clé API ou OAuth2 sur app.infoparcelle.fr/compte/api
  4. Testez les outils : Commencez à interroger les données Infoparcelle avec votre assistant IA préféré