PostcodeDog MCP ServerCerca e verifica codici postali dai tuoi strumenti IA
Collega Claude, ChatGPT, Codex, Cursor, VS Code e altri strumenti IA a PostcodeDog. Cerca codici postali in 82 paesi, verificali secondo il formato nazionale e scomponi indirizzi dal tuo assistente.
https://postdog.zhangjunrock.workers.dev/mcpCosa puoi fare
Chiedi in linguaggio naturale. L’assistente sceglie lo strumento giusto.
Cercare e verificare
Trova un codice postale, una città o un luogo in 82 paesi e controlla il codice secondo il formato nazionale prima di metterlo in un indirizzo.
- Cos’è 90210 e quali altri paesi usano lo stesso codice?
- 75008 è un codice postale francese valido?
- Qual è il codice postale di Shibuya, Tokyo?
- Cerca Monaco di Baviera in Germania e mostrami tre codici.
Capire la copertura
Scopri quali paesi sono coperti, che formato usano e qual è la precisione dei dati per paese.
- Quali paesi europei copri e che formati usano?
- Come sono i codici postali britannici e canadesi?
- Quanti codici postali ci sono nel database?
- Elenca i paesi coperti in Asia, con un codice di esempio per ciascuno.
Lavorare con gli indirizzi
Scomponi un indirizzo completo in paese, regione, città e codice postale, poi verifica che il codice esista prima di usarlo in un modulo o su un’etichetta.
- Scomponi 1 Infinite Loop, Cupertino, CA 95014, USA.
- Quale codice postale corrisponde a 10 Downing Street, Londra?
- Controlla questi codici tedeschi uno per uno: 10115, 80331, 99999.
- Verifica SW1A 1AA e dimmi quale zona di Londra copre.
Installazione
Scegli il tuo strumento IA. Nessuna registrazione e nessuna chiave API: basta l’URL del server.
Claude Code
claude mcp add --transport http --scope user postcodedog https://postdog.zhangjunrock.workers.dev/mcp- Esegui il comando nel terminale.
- Avvia Claude Code, esegui /mcp e scegli postcodedog.
Per provare: chiedi «Cos’è 90210?»
Codex
codex mcp add postcodedog --url https://postdog.zhangjunrock.workers.dev/mcp[mcp_servers.postcodedog]
url = "https://postdog.zhangjunrock.workers.dev/mcp"- Aggiungi il server con il comando o il blocco in ~/.codex/config.toml.
- Avvia Codex. Non c’è alcun passaggio di login: il server è pubblico.
Per provare: chiedi «Qual è il codice postale di 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"
}
}
}- Aggiungi il server con il comando o il blocco nelle impostazioni di Gemini CLI.
- Avvia Gemini CLI ed esegui /mcp per verificare che postcodedog sia connesso.
Per provare: chiedi «75008 è un codice postale francese valido?»
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"
}
}
}- Esegui il comando o salva il blocco come .vscode/mcp.json nel workspace.
- Apri la vista MCP, avvia postcodedog e fai una domanda su un codice postale.
Per provare: chiedi «Quali sono i formati dei codici postali tedeschi e giapponesi?»
Cursor
{
"mcpServers": {
"postcodedog": {
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Unisci il blocco in ~/.cursor/mcp.json o in .cursor/mcp.json del progetto.
- Apri le impostazioni di Cursor → MCP, attiva postcodedog e ricarica la finestra.
Per provare: chiedi «Quali paesi europei copri?»
Claude
https://postdog.zhangjunrock.workers.dev/mcp- Apri Customize → Connectors e scegli Add → Custom → Web.
- Chiamalo PostcodeDog, incolla l’URL del server e lascia vuota l’autenticazione.
- Seleziona Connect: gli strumenti sono subito disponibili, senza login.
Per provare: chiedi «Scomponi 1 Infinite Loop, Cupertino, CA 95014, USA.»
ChatGPT
https://postdog.zhangjunrock.workers.dev/mcp- Apri Plugins, scegli + e poi Add custom MCP server.
- Chiamalo PostcodeDog, incolla l’URL e scegli «No authentication».
- Crea il plugin e fai una domanda su un codice postale in una nuova chat.
Per provare: chiedi «Qual è il codice postale di Shibuya, Tokyo?»
Amp
amp mcp add postcodedog https://postdog.zhangjunrock.workers.dev/mcp- Esegui il comando.
- Amp si connette al primo utilizzo; nessun login.
Per provare: chiedi «99999 esiste in Germania?»
opencode
opencode mcp add postcodedog --global --url https://postdog.zhangjunrock.workers.dev/mcp- Aggiungi il server.
- Avvia opencode e fai una domanda su un codice postale; nessuna autenticazione.
Per provare: chiedi «Quanti luoghi si chiamano Springfield negli USA?»
Other AI tools
Qualsiasi strumento IA che supporti server MCP remoti via Streamable HTTP può connettersi con l’URL. Nessun flusso OAuth e nessuna registrazione del client.
{
"mcpServers": {
"postcodedog": {
"type": "http",
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Imposta l’URL del server nel client e lascia l’autenticazione vuota.
- Il server è senza stato: nessun header di sessione, nessun cookie, nessun handshake initialize.
Per provare: chiedi «Cos’è 90210?»
Domande
Cos’è il server MCP di PostcodeDog?
Collega strumenti IA come Claude, ChatGPT, Cursor e Codex al database di codici postali di PostcodeDog tramite il Model Context Protocol. L’assistente può cercare codici e luoghi, verificare i formati nazionali, scomporre indirizzi e indicare la copertura.
Serve una chiave API?
No. Il server è pubblico e in sola lettura: nessun account, nessun OAuth, nessun token. Incollare l’URL è tutta la configurazione.
Con quali strumenti IA funziona?
Con qualsiasi strumento che supporti server MCP remoti via Streamable HTTP. La guida copre Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp e opencode.
Cosa può vedere l’assistente?
Solo dati postali pubblici: circa 1,8 milioni di righe GeoNames in 82 paesi, con nomi di luoghi, regioni, contee, coordinate e formati nazionali. Non ci sono account, quindi nessun dato personale.
Può modificare qualcosa?
No. I cinque strumenti sono in sola lettura. Il server non può scrivere, inviare o modificare dati, non imposta cookie e non conserva sessioni.
I dati sono accurati?
È il database postale di GeoNames, con licenza CC BY 4.0, aggiornato a ogni rebuild. Nomi e coordinate derivano da record reali. La precisione varia da paese a paese; list_countries indica formato e copertura disponibile per ciascuno.
C’è un limite di richieste?
Nessuna chiave e nessuna quota rigida, ma PostcodeDog è un sito piccolo: mantieni i lotti a un ritmo ragionevole. Per uso intenso o commerciale, contattaci prima.
Come disconnetto?
Rimuovi il server dalle impostazioni del tuo strumento IA. Non conserviamo nulla dalla nostra parte, quindi non c’è altro da revocare.