MCP Recherche d'entreprises

# 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](https://www.data.gouv.fr/fr/dataservices/api-recherche-dentreprises/) ## 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` : ```bash npx mcp-recherche-entreprises ``` #### En tant que développeur 1. Installation des dépendances : ```bash npm install ``` 2. Build du projet : ```bash 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) : ```bash npm run dev ``` Pour lancer le serveur sans l'Inspector : ```bash 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` : ```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](https://modelcontextprotocol.io/docs) - [Spécification MCP](https://modelcontextprotocol.io/spec) - [Exemples de serveurs](https://modelcontextprotocol.io/examples) ### Outils de développement - [SDK TypeScript MCP](https://github.com/modelcontextprotocol/typescript-sdk) - [MCP Inspector](https://github.com/modelcontextprotocol/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](LICENSE) pour plus de détails. ## Contribution Les contributions sont les bienvenues ! Consultez notre [guide de contribution](CONTRIBUTING.md) pour plus d'informations sur la façon de contribuer à ce projet.