insee-mcp 0.1.0

Serveur MCP pour accéder aux données INSEE (SIRENE, BDM, Nomenclatures)

INSEE MCP Server

Serveur MCP (Model Context Protocol) pour accéder aux données de l'INSEE via l'API SIRENE, BDM et les nomenclatures officielles.

⚡ Installation en une ligne

Avec uv (recommandé)

# Installation et lancement direct
API_KEY="your_insee_api_key" uv run --with insee-mcp insee-mcp

Configuration MCP standard

Ajoutez ceci à votre configuration MCP (ex: Claude Desktop) :

{
  "mcpServers": {
    "insee": {
      "command": "uv",
      "args": ["run", "--with", "insee-mcp", "insee-mcp"],
      "env": {
        "API_KEY": "votre_clé_api_insee"
      }
    }
  }
}

Avec pipx

API_KEY="your_insee_api_key" pipx run --spec git+https://github.com/KerryanOPMace/mcp-insee.git insee-mcp

🚀 Installation rapide

Installation directe (recommandée)

# Installation directe depuis GitHub
pip install git+https://github.com/KerryanOPMace/mcp-insee.git

# Configurer votre clé API INSEE
export API_KEY="votre_clé_api_insee"

# Lancer le serveur
insee-mcp

Installation avec pipx (isolée)

# Installation avec pipx (environnement isolé)
pipx install git+https://github.com/KerryanOPMace/mcp-insee.git

# Configurer la clé API
export API_KEY="votre_clé_api_insee"

# Lancer le serveur
insee-mcp

Installation pour développeurs

# Cloner le repository
git clone https://github.com/KerryanOPMace/mcp-insee.git
cd mcp-insee

# Installer en mode développement
pip install -e .

🔑 Configuration

Clé API INSEE

Vous devez obtenir une clé API sur le portail API de l'INSEE et la configurer :

Linux/Mac :

export API_KEY="votre_clé_api_insee"

Windows (PowerShell) :

$env:API_KEY="votre_clé_api_insee"

Windows (CMD) :

set API_KEY=votre_clé_api_insee

🛠️ Outils disponibles

• search_company : Recherche d'entreprises dans la base SIRENE
  • Par SIREN, SIRET ou nom d'entreprise
  • Recherche approximative disponible

🌐 Accès au serveur

Une fois lancé, le serveur MCP est accessible à :

• URL : http://127.0.0.1:8000/mcp
• Transport : Streamable HTTP

🧪 Test du client

from fastmcp import Client
import asyncio

async def test():
    client = Client("http://127.0.0.1:8000/mcp")
    async with client:
        # Lister les outils
        tools = await client.list_tools()
        print(tools)
        
        # Rechercher une entreprise
        result = await client.call_tool("search_company", {
            "siret": "44302124100072"
        })
        print(result)

asyncio.run(test())

📋 Prérequis

• Python 3.8+
• Clé API INSEE valide
• Accès internet pour les requêtes API

📄 Licence

MIT License