MoteurImmo MCP Server

Ce serveur MCP (Model Context Protocol) permet d'intégrer le service MoteurImmo dans des agents IA. Il facilite la recherche et la récupération d'annonces immobilières depuis différents portails immobiliers français.

Fonctionnalités

Recherche d'annonces selon divers critères (prix, surface, localisation, etc.)
Récupération détaillée d'une annonce par son identifiant
Filtrage par options (garage, terrasse, jardin, etc.)
Analyse de négociation (optionnel)
Historique des annonces (optionnel)

Configuration

Utilisation direct de l'API MoteurImmo avec un serveur MCP.

{
    "mcpServers": {
        "moteurimmo": {
            "command": "npx",
            "args": ["-y", "moteurimmo-mcp-server"],
            "env": {
              "MOTEUR_IMMO_API_TOKEN": "YOUR-API-KEY"
            }
        }
    }
}

Installation (pour le développement)

# Installation des dépendances
npm install

# Compilation du projet TypeScript
npm run build

Configuration

Créez un fichier .env à la racine du projet avec les informations suivantes :

MOTEURIMMO_API_URL=https://api.moteurimmo.fr
MOTEURIMMO_API_KEY=votre_clé_api_ici

Utilisation

Démarrage du serveur

# Démarrage normal
npm start

# Démarrage en mode développement avec l'inspecteur MCP
npm run dev

Outils disponibles

Le serveur expose deux outils principaux :

search_ads - Recherche d'annonces avec filtres
get_ad - Récupération d'une annonce spécifique par ID

Exemple d'utilisation

Le serveur s'intègre avec des agents IA compatibles MCP et permet des recherches comme :

"Trouver un appartement à Paris entre 300 000€ et 400 000€ avec au moins 2 chambres"

"Montre-moi les détails de l'annonce avec l'identifiant XYZ123"

Développement

# Compilation en temps réel
npx tsc --watch

# Tests avec l'inspecteur MCP
npm run dev

Licence

Ce projet est sous licence ISC. Voir le fichier LICENSE pour plus de détails.

MoteurImmo MCP Server