This server enables searching for French companies using two main methods:
Textual Search: Find companies by name, address, directors (dirigeants), or elected officials (élus), with filters for:
Geographic areas (EPCI, region, department, commune, postal code)
Certifications (RGE, ESS, Bio, Qualiopi, FINESS)
Company characteristics (legal status, size category, employee count)
Financial metrics (turnover, net result)
Legal categories (associations, public services, société à mission)
Geographic Search: Locate companies within a radius (up to 50km) around specified coordinates, filterable by activity codes (NAF/APE) or activity sections
Both search types support pagination and customizable response detail levels.
MCP Recherche d'entreprises
Ce MCP (Module de Connexion à une API) permet d'interagir avec l'API Recherche d'entreprises mise à disposition par data.gouv.fr.
Description
L'API Recherche d'entreprises permet de rechercher et de trouver des entreprises françaises. Elle offre deux types de recherche :
Recherche textuelle (dénomination, adresse, dirigeants et élus)
Recherche géographique
Related MCP server: Data Gouv MCP Server
Fonctionnalités
Le MCP permet de :
Rechercher des entreprises par différents critères
Filtrer les résultats selon plusieurs paramètres
Accéder aux informations essentielles des entreprises (dénomination, SIREN, SIRET, code NAF)
Effectuer des recherches géographiques autour d'un point avec les paramètres suivants :
Latitude et longitude du point de recherche
Rayon de recherche (jusqu'à 50km)
Filtres d'activité (code NAF, section d'activité)
Pagination des résultats
Source
Ce MCP est basé sur l'API officielle de data.gouv.fr : API Recherche d'entreprises
Limitations
L'API comporte certaines limitations :
Ne donne pas accès aux prédécesseurs et successeurs d'un établissement
Ne permet pas d'accéder aux entreprises non-diffusibles
Ne permet pas d'accéder aux entreprises qui se sont vues refuser leur immatriculation au RCS
Le rayon de recherche géographique est limité à 50km maximum
Limites techniques
Limite de 7 appels par seconde
Disponibilité : 100% sur le mois dernier
Accès : Ouvert à tous
Utilisation
En tant qu'utilisateur
Le moyen le plus simple d'utiliser ce MCP est via npx :
En tant que développeur
Installation des dépendances :
Build du projet :
Cette commande va :
Compiler les fichiers TypeScript en JavaScript
Les placer dans le dossier
dist/Rendre les fichiers JavaScript exécutables
Démarrage :
Pour lancer le serveur en mode développement avec l'Inspector MCP (recommandé pour le développement) :
Pour lancer le serveur sans l'Inspector :
L'Inspector MCP fournit une interface graphique pour tester et déboguer les requêtes MCP en temps réel.
Utilisation avec Cursor
Pour utiliser ce MCP dans Cursor, ajoutez la configuration suivante dans votre fichier .cursor/settings.json :
Cette configuration permettra à Cursor d'utiliser automatiquement ce MCP pour les recherches d'entreprises.
Ressources MCP pour les contributeurs
Documentation officielle
Outils de développement
MCP Inspector - Outil de débogage et d'analyse
Bonnes pratiques
Utiliser le SDK TypeScript pour l'implémentation
Suivre les conventions de code du projet
Implémenter une gestion d'erreur robuste
Documenter clairement l'API
Maintenir la compatibilité avec les versions futures
Tests et débogage
Utiliser l'Inspector pour le débogage
Implémenter des tests unitaires
Vérifier la conformité avec la spécification MCP
Analyser les performances avec les outils appropriés
Licence
Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.
Contribution
Les contributions sont les bienvenues ! Consultez notre guide de contribution pour plus d'informations sur la façon de contribuer à ce projet.