PostcodeDog MCP ServerRecherchez et validez des codes postaux depuis vos outils IA
Connectez Claude, ChatGPT, Codex, Cursor, VS Code et d’autres outils IA à PostcodeDog. Recherchez des codes postaux dans 82 pays, validez-les selon le format national et décomposez des adresses depuis votre assistant.
https://postdog.zhangjunrock.workers.dev/mcpCe que vous pouvez faire
Posez la question en langage naturel. Votre assistant choisit le bon outil.
Rechercher et valider
Trouvez un code postal, une ville ou un lieu dans 82 pays, et vérifiez le code selon le format national avant de l’insérer dans une adresse.
- Qu’est-ce que 90210, et quels autres pays utilisent le même code ?
- 75008 est-il un code postal français valide ?
- Quel code postal correspond à Shibuya, Tokyo ?
- Cherche Munich en Allemagne et donne-moi trois codes.
Comprendre la couverture
Voyez quels pays sont couverts, quel format ils utilisent et quel est le niveau de précision par pays.
- Quels pays européens couvrez-vous, et avec quels formats ?
- À quoi ressemblent les codes postaux britanniques et canadiens ?
- Combien de codes postaux compte la base ?
- Liste les pays couverts en Asie, avec un code d’exemple pour chacun.
Travailler avec des adresses
Décomposez une adresse complète en pays, région, ville et code postal, puis vérifiez que le code existe avant de l’utiliser dans un formulaire ou une étiquette.
- Décompose 1 Infinite Loop, Cupertino, CA 95014, USA.
- Quel code postal correspond au 10 Downing Street, Londres ?
- Vérifie ces codes allemands un par un : 10115, 80331, 99999.
- Valide SW1A 1AA et dis-moi quelle zone de Londres il couvre.
Installation
Choisissez votre outil IA. Ni inscription ni clé API — l’URL du serveur suffit.
Claude Code
claude mcp add --transport http --scope user postcodedog https://postdog.zhangjunrock.workers.dev/mcp- Exécutez la commande dans le terminal.
- Lancez Claude Code, exécutez /mcp et choisissez postcodedog.
Pour vérifier : demandez « Qu’est-ce que 90210 ? »
Codex
codex mcp add postcodedog --url https://postdog.zhangjunrock.workers.dev/mcp[mcp_servers.postcodedog]
url = "https://postdog.zhangjunrock.workers.dev/mcp"- Ajoutez le serveur avec la commande, ou le bloc dans ~/.codex/config.toml.
- Lancez Codex. Aucune étape de connexion — le serveur est public.
Pour vérifier : demandez « Quel code postal correspond à Beverly Hills 90210 ? »
Gemini CLI
gemini mcp add --transport http --scope user postcodedog https://postdog.zhangjunrock.workers.dev/mcp{
"mcpServers": {
"postcodedog": {
"httpUrl": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Ajoutez le serveur avec la commande, ou le bloc dans les réglages de Gemini CLI.
- Lancez Gemini CLI et exécutez /mcp pour vérifier que postcodedog est connecté.
Pour vérifier : demandez « 75008 est-il un code postal français valide ? »
VS Code
code --add-mcp '{"name":"postcodedog","type":"http","url":"https://postdog.zhangjunrock.workers.dev/mcp"}'{
"servers": {
"postcodedog": {
"type": "http",
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Exécutez la commande, ou enregistrez le bloc dans .vscode/mcp.json du workspace.
- Ouvrez la vue MCP, démarrez postcodedog et posez une question de code postal.
Pour vérifier : demandez « Quels sont les formats des codes postaux allemands et japonais ? »
Cursor
{
"mcpServers": {
"postcodedog": {
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Fusionnez le bloc dans ~/.cursor/mcp.json, ou dans .cursor/mcp.json du projet.
- Ouvrez les réglages Cursor → MCP, activez postcodedog et rechargez la fenêtre.
Pour vérifier : demandez « Quels pays d’Europe couvrez-vous ? »
Claude
https://postdog.zhangjunrock.workers.dev/mcp- Ouvrez Customize → Connectors, puis Add → Custom → Web.
- Nommez-le PostcodeDog, collez l’URL du serveur et laissez l’authentification vide.
- Sélectionnez Connect — les outils sont disponibles immédiatement, sans connexion.
Pour vérifier : demandez « Décompose 1 Infinite Loop, Cupertino, CA 95014, USA. »
ChatGPT
https://postdog.zhangjunrock.workers.dev/mcp- Ouvrez Plugins, sélectionnez +, puis Add custom MCP server.
- Nommez-le PostcodeDog, collez l’URL et choisissez « No authentication ».
- Créez le plugin et posez une question de code postal dans une nouvelle conversation.
Pour vérifier : demandez « Quel est le code postal de Shibuya, Tokyo ? »
Amp
amp mcp add postcodedog https://postdog.zhangjunrock.workers.dev/mcp- Exécutez la commande.
- Amp se connecte à la première utilisation ; aucune connexion requise.
Pour vérifier : demandez « 99999 existe-t-il en Allemagne ? »
opencode
opencode mcp add postcodedog --global --url https://postdog.zhangjunrock.workers.dev/mcp- Ajoutez le serveur.
- Lancez opencode et posez une question de code postal ; aucune authentification.
Pour vérifier : demandez « Combien de lieux s’appellent Springfield aux États-Unis ? »
Other AI tools
Tout outil IA qui prend en charge les serveurs MCP distants via Streamable HTTP peut se connecter avec l’URL. Aucun flux OAuth ni enregistrement de client.
{
"mcpServers": {
"postcodedog": {
"type": "http",
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Indiquez l’URL du serveur au client et laissez l’authentification vide.
- Le serveur est sans état — pas d’en-tête de session, pas de cookies, pas de handshake initialize.
Pour vérifier : demandez « Qu’est-ce que 90210 ? »
Questions
Qu’est-ce que le serveur MCP PostcodeDog ?
Il relie des outils IA comme Claude, ChatGPT, Cursor et Codex à la base de codes postaux de PostcodeDog via le Model Context Protocol. L’assistant peut chercher des codes, des lieux, valider selon les formats nationaux, décomposer des adresses et indiquer la couverture.
Faut-il une clé API ?
Non. Le serveur est public et en lecture seule : aucun compte, aucun OAuth, aucun jeton. Coller l’URL suffit.
Avec quels outils IA fonctionne-t-il ?
Tout outil prenant en charge les serveurs MCP distants via Streamable HTTP. Le guide couvre Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp et opencode.
Que peut voir mon assistant ?
Uniquement des données postales publiques : environ 1,8 million de lignes GeoNames dans 82 pays, avec noms de lieux, régions, comtés, coordonnées et formats nationaux. Aucun compte, donc aucune donnée personnelle.
Peut-il modifier quelque chose ?
Non. Les cinq outils sont en lecture seule. Le serveur ne peut rien écrire, soumettre ou modifier, ne pose aucun cookie et ne garde aucune session.
Les données sont-elles exactes ?
C’est la base postale GeoNames, sous licence CC BY 4.0, actualisée à chaque reconstruction. Les noms de lieux et les coordonnées proviennent d’enregistrements réels. La précision varie selon le pays ; list_countries indique le format et la couverture disponible pour chacun.
Y a-t-il une limite de débit ?
Pas de clé ni de quota strict, mais PostcodeDog est un petit site : gardez les traitements par lot à un rythme raisonnable. Pour un usage intensif ou commercial, contactez-nous d’abord.
Comment déconnecter ?
Retirez le serveur des réglages de votre outil IA. Rien n’est stocké de notre côté, il n’y a donc rien d’autre à révoquer.