mcp-recherche-entreprise

# Serveur MCP data.gouv.fr Un serveur MCP (Model Context Protocol) pour accéder aux données de [data.gouv.fr](https://www.data.gouv.fr), la plateforme française de données ouvertes. ## 🚀 Fonctionnalités Ce serveur MCP fournit actuellement l'outil suivant pour interagir avec l'API recherche-entreprises.api.gouv.fr : ### Recherche d'entreprises - **`search_companies`** : Rechercher des entreprises via l'API recherche-entreprises.api.gouv.fr ## 📋 Prérequis - Node.js 18+ - npm ou yarn ## 🛠️ Installation 1. Clonez le repository : ```bash git clone <repository-url> cd mcp-data-gouv-server ``` 2. Installez les dépendances : ```bash npm install ``` 3. Copiez le fichier d'exemple d'environnement : ```bash cp env.example .env ``` 4. Compilez le projet : ```bash npm run build ``` ## 🚀 Utilisation ### Mode développement ```bash npm run dev ``` ### Mode production ```bash npm run build npm start ``` ## 🔧 Configuration Le serveur utilise les variables d'environnement suivantes (optionnelles) : - `API_RATE_LIMIT` : Limite de taux pour les requêtes API - `API_TIMEOUT` : Timeout pour les requêtes API en millisecondes ## 📖 API des outils ### search_companies Rechercher des entreprises via l'API recherche-entreprises.api.gouv.fr. **Paramètres :** - `query` (requis) : Recherche libre (nom, SIREN, SIRET, etc.) - `page` (optionnel) : Numéro de page (défaut: 1) - `page_size` (optionnel) : Nombre de résultats par page (défaut: 10) - `activite_principale` (optionnel) : Code NAF/APE - `code_postal` (optionnel) : Code postal (5 chiffres ou liste séparée par des virgules) - `tranche_effectif_salarie` (optionnel) : Tranche d'effectif salarié INSEE - `est_association` (optionnel) : Est une association - `est_bio` (optionnel) : Uniquement les entreprises certifiées bio - `est_organisme_formation` (optionnel) : Uniquement les organismes de formation - `est_qualiopi` (optionnel) : Uniquement les entreprises certifiées Qualiopi ## 🔗 Intégration avec un client MCP Pour utiliser ce serveur avec un client MCP, ajoutez la configuration suivante à votre fichier de configuration MCP : ```json { "mcpServers": { "data-gouv": { "command": "node", "args": ["/path/to/mcp-data-gouv-server/dist/server.js"], "env": { "NODE_ENV": "production" } } } } ``` ## 📝 Exemples d'utilisation ### Recherche d'entreprises par nom ``` search_companies({ "query": "Apple", "page_size": 5 }) ``` ### Recherche d'entreprises par code postal ``` search_companies({ "query": "", "code_postal": "75001", "page_size": 10 }) ``` ### Recherche d'entreprises par activité ``` search_companies({ "query": "", "activite_principale": "62.02A", "page_size": 5 }) ``` ### Recherche d'associations ``` search_companies({ "query": "association", "est_association": true, "page_size": 10 }) ``` ## 🧪 Tests Le projet inclut des scripts de test pour vérifier le bon fonctionnement : ```bash # Test des APIs npm run test:apis # Test de l'intégration avec Cursor npm run test:cursor ``` ## 🤝 Contribution Les contributions sont les bienvenues ! N'hésitez pas à : 1. Fork le projet 2. Créer une branche pour votre fonctionnalité 3. Commiter vos changements 4. Pousser vers la branche 5. Ouvrir une Pull Request ## 📄 Licence Ce projet est sous licence ISC. ## 🔗 Liens utiles - [API recherche-entreprises.api.gouv.fr](https://recherche-entreprises.api.gouv.fr/) - [Spécification MCP](https://modelcontextprotocol.io/) - [Plateforme data.gouv.fr](https://www.data.gouv.fr/)