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

Assurez-vous que le fichier de configuration est correctement enregistré
Redémarrez complètement Claude Desktop
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

Serveur MCP pour Claude