samy-clivolt/serper-mcp-server-fixed

Serper MCP Server (Version corrigée)

🚀 Version corrigée du serveur MCP Serper avec endpoints spécifiques et support complet des paramètres

Un serveur Model Context Protocol qui fournit Google Search via Serper avec des endpoints corrigés selon la documentation officielle de Serper.

🆕 Corrections apportées dans cette version

• ✅ Endpoints spécifiques : Utilisation des bons endpoints pour chaque type de recherche
• ✅ Places Search : Endpoint corrigé https://google.serper.dev/places
• ✅ Reviews Search : Endpoint corrigé https://google.serper.dev/reviews
• ✅ Nouveau schéma PlacesRequest : Paramètres optimisés pour les recherches de lieux
• ✅ ReviewsRequest amélioré : Paramètre fid rendu optionnel
• ✅ Support complet : Paramètres gl, hl, location correctement gérés
• ✅ Tests validés : Fonctionnement vérifié avec des cas d'usage réels

📋 Outils disponibles

• google_search - Recherche Google standard
• google_search_images - Recherche d'images
• google_search_videos - Recherche de vidéos
• google_search_places - [CORRIGÉ] Recherche de lieux avec endpoint spécifique
• google_search_maps - Recherche sur Google Maps
• google_search_reviews - [CORRIGÉ] Recherche d'avis avec paramètres flexibles
• google_search_news - Recherche d'actualités
• google_search_shopping - Recherche shopping
• google_search_lens - Recherche Google Lens
• google_search_scholar - Recherche Google Scholar
• google_search_parents - Recherche parental
• google_search_autocomplete - Autocomplétion
• webpage_scrape - Scraping de pages web

🔧 Utilisation

Configuration avec uv (recommandé)

1. Assurez-vous d'avoir installé uv sur votre système.

2. Dans votre configuration MCP client ou les paramètres Claude (fichier claude_desktop_config.json), ajoutez le serveur MCP serper :

   {
       "mcpServers": {
           "serper": {
               "command": "uvx",
               "args": ["serper-mcp-server"],
               "env": {
                   "SERPER_API_KEY": "<Votre clé API Serper>"
               }
           }
       }
   }
   

Configuration avec pip

1. Installez le package :

   pip install serper-mcp-server
   

2. Configuration pour votre client MCP :

   {
       "mcpServers": {
           "serper": {
               "command": "python3",
               "args": ["-m", "serper_mcp_server"],
               "env": {
                   "SERPER_API_KEY": "<Votre clé API Serper>"
               }
           }
       }
   }
   

🧪 Exemple d'utilisation

Recherche de lieux (Places)

# Recherche de lieux avec les paramètres corrigés
{
    "q": "Smartch",
    "location": "France", 
    "gl": "fr",
    "hl": "fr"
}

Recherche d'avis (Reviews)

# Recherche d'avis avec CID obtenu via Places
{
    "cid": "17077932821649815749",
    "gl": "fr",
    "hl": "fr"
}

🐛 Débogage

Vous pouvez utiliser l'inspecteur MCP pour déboguer le serveur :

npx @modelcontextprotocol/inspector uvx serper-mcp-server

Ou pour le développement local :

cd path/to/servers/src/serper
npx @modelcontextprotocol/inspector uv run serper-mcp-server -e SERPER_API_KEY=<votre-clé>

📝 Changelog

Version corrigée (2024)

• [FIX] Correction des endpoints pour correspondre à la documentation Serper
• [NEW] Ajout du schéma PlacesRequest spécifique
• [IMPROVE] Paramètre fid optionnel dans ReviewsRequest
• [TEST] Validation complète avec cas d'usage réels

Version originale

• Implémentation initiale du serveur MCP Serper
• Support de base pour tous les types de recherche

🔑 Obtenir une clé API Serper

1. Créez un compte sur serper.dev
2. Récupérez votre clé API depuis le dashboard
3. Configurez la variable d'environnement SERPER_API_KEY

📄 Licence

Ce serveur MCP Serper est sous licence MIT. Vous êtes libre d'utiliser, modifier et distribuer le logiciel selon les termes de la licence MIT.