PostcodeDog MCP ServerAI ツールから郵便番号を検索・検証
Claude、ChatGPT、Codex、Cursor、VS Code などの AI ツールを PostcodeDog につなぎます。使い慣れたアシスタントから 82 か国の郵便番号を検索し、各国の形式で検証し、住所を分解できます。
https://postdog.zhangjunrock.workers.dev/mcpできること
自然言語で聞くだけ。アシスタントが適切なツールを選びます。
検索と検証
82 か国で郵便番号・都市・地名を検索し、住所に入れる前に各国の形式で検証します。
- 90210 はどこ？同じ番号を使う国はほかにある？
- 75008 は有効なフランスの郵便番号？
- 東京・渋谷の郵便番号は？
- ドイツのミュンヘンを調べて、郵便番号を 3 つ見せて。
カバレッジ
どの国にデータがあり、形式は何か、国ごとの精度まで確認できます。
- ヨーロッパで対応している国と形式は？
- 英国とカナダの郵便番号はどんな形式？
- データベースには郵便番号がいくつ収録されている？
- アジアで対応している国を、それぞれ例つきで挙げて。
住所の解析
住所を国・地域・都市・郵便番号に分解し、フォームや送り状に使う前に実在するか確認します。
- 1 Infinite Loop, Cupertino, CA 95014, USA を解析して。
- ロンドンのダウニング街 10 番の郵便番号は？
- このドイツの番号を 1 つずつ確認して：10115、80331、99999。
- SW1A 1AA を検証して、ロンドンのどの地域か教えて。
インストール
AI ツールを選んでください。ログインも API キーも不要——サーバー URL だけで使えます。
Claude Code
claude mcp add --transport http --scope user postcodedog https://postdog.zhangjunrock.workers.dev/mcp- ターミナルでコマンドを実行します。
- Claude Code を起動し、/mcp を実行して postcodedog を選びます。
動作確認： 「90210 はどこ？」と聞いてみる
Codex
codex mcp add postcodedog --url https://postdog.zhangjunrock.workers.dev/mcp[mcp_servers.postcodedog]
url = "https://postdog.zhangjunrock.workers.dev/mcp"- コマンドで追加するか、設定ブロックを ~/.codex/config.toml に書きます。
- Codex を起動します。ログイン手順はありません——公開サーバーです。
動作確認： 「ビバリーヒルズ 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"
}
}
}- コマンドで追加するか、設定ブロックを Gemini CLI の設定に書きます。
- Gemini CLI を起動し、/mcp で postcodedog が接続されているか確認します。
動作確認： 「75008 は有効なフランスの郵便番号？」と聞いてみる
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"
}
}
}- コマンドを実行するか、設定ブロックをワークスペースの .vscode/mcp.json に保存します。
- MCP ビューを開いて postcodedog を起動し、郵便番号の質問をします。
動作確認： 「ドイツと日本の郵便番号の形式は？」と聞いてみる
Cursor
{
"mcpServers": {
"postcodedog": {
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- 設定ブロックを ~/.cursor/mcp.json、またはプロジェクトの .cursor/mcp.json にマージします。
- Cursor の設定 → MCP で postcodedog を有効にし、ウィンドウを再読み込みします。
動作確認： 「ヨーロッパで対応している国は？」と聞いてみる
Claude
https://postdog.zhangjunrock.workers.dev/mcp- Customize → Connectors を開き、Add → Custom → Web を選びます。
- 名前を PostcodeDog にしてサーバー URL を貼り、認証は空のままにします。
- Connect を押すとすぐ使えます。ログインは不要です。
動作確認： 「1 Infinite Loop, Cupertino, CA 95014, USA を解析して。」と聞いてみる
ChatGPT
https://postdog.zhangjunrock.workers.dev/mcp- Plugins を開き、+ を選んで Add custom MCP server を押します。
- 名前を PostcodeDog にして URL を貼り、認証は「No authentication」を選びます。
- プラグインを作成し、新しいチャットで郵便番号の質問をします。
動作確認： 「東京・渋谷の郵便番号は？」と聞いてみる
Amp
amp mcp add postcodedog https://postdog.zhangjunrock.workers.dev/mcp- コマンドを実行します。
- Amp は初回接続ですぐ使えます。ログインは不要です。
動作確認： 「99999 はドイツに存在する？」と聞いてみる
opencode
opencode mcp add postcodedog --global --url https://postdog.zhangjunrock.workers.dev/mcp- サーバーを追加します。
- opencode を起動して郵便番号の質問をするだけ。認証は不要です。
動作確認： 「アメリカに Springfield という場所はいくつある？」と聞いてみる
Other AI tools
Streamable HTTP のリモート MCP に対応した AI ツールなら、この URL で接続できます。OAuth もクライアント登録も不要です。
{
"mcpServers": {
"postcodedog": {
"type": "http",
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- クライアントにサーバー URL を設定し、認証は空のままにします。
- サーバーはステートレスです——セッションヘッダー、Cookie、initialize ハンドシェイクは不要です。
動作確認： 「90210 はどこ？」と聞いてみる
よくある質問
PostcodeDog MCP サーバーとは？
Model Context Protocol を通じて、Claude、ChatGPT、Cursor、Codex などの AI ツールを PostcodeDog の郵便番号データベースにつなぎます。郵便番号の検索、地名検索、各国形式での検証、住所の解析、カバレッジの確認ができます。
API キーは必要ですか？
いいえ。読み取り専用で公開されています：アカウントも OAuth もトークンもありません。URL を貼るだけで設定は完了です。
どの AI ツールで使えますか？
Streamable HTTP のリモート MCP に対応したツールなら何でも使えます。ガイドでは Claude Code、Codex、Gemini CLI、VS Code、Cursor、Claude、ChatGPT、Amp、opencode を扱っています。
アシスタントは何を見られますか？
公開されている郵便番号データだけです：82 か国、約 180 万行の GeoNames レコード（地名、地域、郡、座標、各国の形式）。アカウントがないので、個人情報は存在しません。
何かを変更しますか？
いいえ。5 つのツールはすべて読み取り専用です。書き込み・送信・変更はできず、Cookie もセッションも保持しません。
データは正確ですか？
GeoNames の郵便番号データ（CC BY 4.0）で、再構築のたびに更新されます。地名と座標は実在する記録に基づきます。国ごとに精度が異なるため、list_countries で各国の形式と利用できる範囲を確認できます。
レート制限はありますか？
キーも厳密な割り当てもありませんが、PostcodeDog は小さなサイトです。バッチ処理は常識的な頻度にしてください。高負荷や商用利用の場合は事前にご連絡ください。
接続を解除するには？
AI ツールの設定からサーバーを削除してください。こちら側には何も保存していないので、他に取り消すものはありません。