Documentation

Serveur MCP pour Claude

Qu'est-ce que MCP ?

MCP (Model Context Protocol) est un standard qui permet aux assistants IA comme Claude d'interagir avec des outils et sources de données externes. Notre Serveur MCP permet à Claude de consulter des pays, états, villes et codes postaux directement dans les conversations.

Installation

Installez globalement via npm :

npm install -g @countrydataapi/mcp-server

Ou utilisez directement avec npx (aucune installation requise) :

npx @countrydataapi/mcp-server

Configuration pour Claude Desktop

Ajoutez ce qui suit à votre fichier de configuration Claude Desktop :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "country-data-api": {
      "command": "npx",
      "args": ["@countrydataapi/mcp-server"],
      "env": {
        "COUNTRY_DATA_API_KEY": "votre-cle-api-ici"
      }
    }
  }
}

Après avoir enregistré la configuration, redémarrez Claude Desktop.

Outils Disponibles

Une fois configuré, Claude aura accès aux outils suivants :

Pays

Outil Description
get_countries_all Obtenir tous les pays
get_country_by_name Obtenir un pays par nom
get_country_by_code Obtenir un pays par code ISO (FR, FRA, 250)
get_countries_by_region Obtenir des pays par région (Europe, Asie, etc.)
get_countries_by_currency Obtenir des pays par devise (EUR, USD, etc.)
get_countries_by_language Obtenir des pays par langue (fra, eng, etc.)
get_countries_by_timezone Obtenir des pays par fuseau horaire

États/Régions

Outil Description
get_states_all Obtenir tous les états/régions
get_states_by_country Obtenir les régions d'un pays
get_states_by_city Obtenir les régions contenant une ville

Villes

Outil Description
get_cities_all Obtenir toutes les villes
get_city Obtenir une ville par nom
get_cities_by_country Obtenir les villes d'un pays
get_cities_by_state Obtenir les villes d'une région

Codes Postaux

Outil Description
get_zipcodes_by_country Obtenir les codes postaux d'un pays
get_zipcodes_by_state Obtenir les codes postaux d'une région

Select (Optimisé - 1 token chacun)

Outil Description
get_select_countries Liste légère de pays pour listes déroulantes
get_select_states Liste légère de régions pour listes déroulantes
get_select_cities Liste légère de villes pour listes déroulantes

Statut

Outil Description
get_api_status Obtenir les tokens API restants

Exemples de Conversations

Une fois configuré, vous pouvez demander à Claude des choses comme :

Obtenir des Informations sur les Pays

"Quels pays sont en Europe ?" "Parle-moi de la France" "Quelle est la capitale de l'Allemagne ?"

Trouver des États/Régions

"Quelles régions y a-t-il en France ?" "Liste les provinces du Canada"

Requêtes sur les Villes

"Quelles villes y a-t-il en Île-de-France ?" "Trouve des villes dans la région de Lyon"

Gestion des Tokens

"Combien de tokens API me reste-t-il ?"

Paramètres Communs

La plupart des outils acceptent ces paramètres optionnels :

Paramètre Description
lang Langue de la réponse : en, es, pt, fr, de, it
fields Liste de champs séparés par des virgules à retourner
limitToken Maximum de tokens à utiliser pour cette requête

Variables d'Environnement

Variable Description Requis
COUNTRY_DATA_API_KEY Votre clé API de countrydataapi.com Oui

Dépannage

Claude ne voit pas les outils

  1. Assurez-vous que le fichier de configuration est correctement enregistré
  2. Redémarrez complètement Claude Desktop
  3. Vérifiez que votre clé API est valide

Erreur : Clé API invalide

Vérifiez que votre clé API est correcte et qu'il reste des tokens. Vous pouvez vérifier votre solde de tokens dans le tableau de bord de votre compte.

Les outils sont lents

Le serveur MCP utilise la même API que les requêtes directes. Si les requêtes sont lentes, essayez :

  • D'utiliser des requêtes plus spécifiques (ex. : rechercher par pays au lieu de tous)
  • De limiter les résultats avec limitToken
  • D'utiliser les endpoints select pour les données de listes déroulantes

Notes de Sécurité

  • Votre clé API est stockée localement dans la configuration de Claude Desktop
  • Le serveur MCP communique uniquement avec la Country Data API
  • Aucune donnée n'est envoyée à des tiers

Liens