# MCP Recherche d'entreprises

> **⚠️ Ce projet n'est pas affilié à data.gouv.fr et ne constitue pas le serveur MCP officiel.**
> Le serveur MCP officiel de data.gouv.fr est disponible ici : [datagouv-mcp](https://github.com/datagouv/datagouv-mcp).
> Ce repository est désormais archivé. Nous vous recommandons d'utiliser le serveur officiel.

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.