Serveur MCP data.gouv.fr

Un serveur MCP (Model Context Protocol) pour accéder aux données de 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 :

git clone <repository-url>
cd mcp-data-gouv-server

1. Installez les dépendances :

npm install

1. Copiez le fichier d'exemple d'environnement :

cp env.example .env

1. Compilez le projet :

npm run build

🚀 Utilisation

Mode développement

npm run dev

Mode production

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 :

{
  "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 :

# 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
• Spécification MCP
• Plateforme data.gouv.fr