Content
# 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/)
Connection Info
You Might Also Like
markitdown
Python tool for converting files and office documents to Markdown.
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.
antigravity-awesome-skills
The Ultimate Collection of 130+ Agentic Skills for Claude...
opik
Opik is a versatile tool for managing and tracking experiments in machine learning.