What is Mcp Recherche Entreprises

mcp-recherche-entreprises is a Module for Connecting to an API that allows users to interact with the Enterprise Search API provided by data.gouv.fr, enabling the search and retrieval of information about French companies.

Use cases

Use cases for mcp-recherche-entreprises include conducting market research to identify potential competitors, analyzing industry trends by accessing company data, and supporting business development efforts by finding relevant companies in specific sectors.

How to use

To use mcp-recherche-entreprises, you can send requests to the API with various search criteria such as company name, address, or geographical location. The results can be filtered based on multiple parameters to access essential company information.

Key features

Key features of mcp-recherche-entreprises include the ability to search for companies by different criteria, filter results based on various parameters, and access essential company information such as name, SIREN, SIRET, and NAF code.

Where to use

mcp-recherche-entreprises can be used in various fields such as business research, market analysis, and economic studies, where there is a need to gather information about French companies.

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

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 :

npx mcp-recherche-entreprises

En tant que développeur

1. Installation des dépendances :

npm install

2. Build du projet :

npm run build

Cette commande va :

• Compiler les fichiers TypeScript en JavaScript
• Les placer dans le dossier dist/
• Rendre les fichiers JavaScript exécutables

3. Démarrage :

Pour lancer le serveur en mode développement avec l’Inspector MCP (recommandé pour le développement) :

npm run dev

Pour lancer le serveur sans l’Inspector :

npm start

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 :

{
  "mcpServers": {
    "recherche-entreprises": {
      "command": "npx mcp-recherche-entreprises"
    }
  }
}

Cette configuration permettra à Cursor d’utiliser automatiquement ce MCP pour les recherches d’entreprises.

Ressources MCP pour les contributeurs

Documentation officielle

• Documentation MCP
• Spécification MCP
• Exemples de serveurs

Outils de développement

• SDK TypeScript MCP
• 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.