# PostcodeDog MCP Server

**AI ツールから郵便番号を検索・検証**

Claude、ChatGPT、Codex、Cursor、VS Code などの AI ツールを PostcodeDog につなぎます。使い慣れたアシスタントから 82 か国の郵便番号を検索し、各国の形式で検証し、住所を分解できます。

Endpoint: https://postcode.dog/mcp

Streamable HTTP · 登録不要 · API キー不要

> Source: https://postcode.dog/mcp/install

## できること

自然言語で聞くだけ。アシスタントが適切なツールを選びます。

### 検索と検証

82 か国で郵便番号・都市・地名を検索し、住所に入れる前に各国の形式で検証します。

- 90210 はどこ？同じ番号を使う国はほかにある？
- 75008 は有効なフランスの郵便番号？
- 東京・渋谷の郵便番号は？
- ドイツのミュンヘンを調べて、郵便番号を 3 つ見せて。

### カバレッジ

どの国にデータがあり、形式は何か、国ごとの精度まで確認できます。

- ヨーロッパで対応している国と形式は？
- 英国とカナダの郵便番号はどんな形式？
- データベースには郵便番号がいくつ収録されている？
- アジアで対応している国を、それぞれ例つきで挙げて。

### 住所の解析

住所を国・地域・都市・郵便番号に分解し、フォームや送り状に使う前に実在するか確認します。

- 1 Infinite Loop, Cupertino, CA 95014, USA を解析して。
- ロンドンのダウニング街 10 番の郵便番号は？
- このドイツの番号を 1 つずつ確認して：10115、80331、99999。
- SW1A 1AA を検証して、ロンドンのどの地域か教えて。

## Tools

- `lookup_postal_code` — Resolve a postal code, city, or place name; optional country and limit.
- `search_places` — Full-text search over place names, optionally limited to one country.
- `validate_postal_code` — Check a code against the national format and the database.
- `parse_address` — Split a free-form or labelled address into fields and resolve its code.
- `list_countries` — List covered countries with format, example, coverage note, and counts.

## インストール

AI ツールを選んでください。ログインも API キーも不要——サーバー URL だけで使えます。

### Claude Code

```bash
claude mcp add --transport http --scope user postcodedog https://postcode.dog/mcp
```

1. ターミナルでコマンドを実行します。
2. Claude Code を起動し、/mcp を実行して postcodedog を選びます。

**動作確認：** 「90210 はどこ？」と聞いてみる

### Codex

```bash
codex mcp add postcodedog --url https://postcode.dog/mcp
```

`~/.codex/config.toml`

```toml
[mcp_servers.postcodedog]
url = "https://postcode.dog/mcp"
```

1. コマンドで追加するか、設定ブロックを ~/.codex/config.toml に書きます。
2. Codex を起動します。ログイン手順はありません——公開サーバーです。

**動作確認：** 「ビバリーヒルズ 90210 の郵便番号は？」と聞いてみる

### Gemini CLI

```bash
gemini mcp add --transport http --scope user postcodedog https://postcode.dog/mcp
```

`settings.json`

```json
{
  "mcpServers": {
    "postcodedog": {
      "httpUrl": "https://postcode.dog/mcp"
    }
  }
}
```

1. コマンドで追加するか、設定ブロックを Gemini CLI の設定に書きます。
2. Gemini CLI を起動し、/mcp で postcodedog が接続されているか確認します。

**動作確認：** 「75008 は有効なフランスの郵便番号？」と聞いてみる

### VS Code

```bash
code --add-mcp '{"name":"postcodedog","type":"http","url":"https://postcode.dog/mcp"}'
```

`.vscode/mcp.json`

```json
{
  "servers": {
    "postcodedog": {
      "type": "http",
      "url": "https://postcode.dog/mcp"
    }
  }
}
```

1. コマンドを実行するか、設定ブロックをワークスペースの .vscode/mcp.json に保存します。
2. MCP ビューを開いて postcodedog を起動し、郵便番号の質問をします。

**動作確認：** 「ドイツと日本の郵便番号の形式は？」と聞いてみる

### Cursor

`~/.cursor/mcp.json`

```json
{
  "mcpServers": {
    "postcodedog": {
      "url": "https://postcode.dog/mcp"
    }
  }
}
```

1. 設定ブロックを ~/.cursor/mcp.json、またはプロジェクトの .cursor/mcp.json にマージします。
2. Cursor の設定 → MCP で postcodedog を有効にし、ウィンドウを再読み込みします。

**動作確認：** 「ヨーロッパで対応している国は？」と聞いてみる

### Claude

```text
https://postcode.dog/mcp
```

1. Customize → Connectors を開き、Add → Custom → Web を選びます。
2. 名前を PostcodeDog にしてサーバー URL を貼り、認証は空のままにします。
3. Connect を押すとすぐ使えます。ログインは不要です。

**動作確認：** 「1 Infinite Loop, Cupertino, CA 95014, USA を解析して。」と聞いてみる

### ChatGPT

```text
https://postcode.dog/mcp
```

1. Plugins を開き、+ を選んで Add custom MCP server を押します。
2. 名前を PostcodeDog にして URL を貼り、認証は「No authentication」を選びます。
3. プラグインを作成し、新しいチャットで郵便番号の質問をします。

**動作確認：** 「東京・渋谷の郵便番号は？」と聞いてみる

### Amp

```bash
amp mcp add postcodedog https://postcode.dog/mcp
```

1. コマンドを実行します。
2. Amp は初回接続ですぐ使えます。ログインは不要です。

**動作確認：** 「99999 はドイツに存在する？」と聞いてみる

### opencode

```bash
opencode mcp add postcodedog --global --url https://postcode.dog/mcp
```

1. サーバーを追加します。
2. opencode を起動して郵便番号の質問をするだけ。認証は不要です。

**動作確認：** 「アメリカに Springfield という場所はいくつある？」と聞いてみる

### Other AI tools

Streamable HTTP のリモート MCP に対応した AI ツールなら、この URL で接続できます。OAuth もクライアント登録も不要です。

`mcp.json`

```json
{
  "mcpServers": {
    "postcodedog": {
      "type": "http",
      "url": "https://postcode.dog/mcp"
    }
  }
}
```

1. クライアントにサーバー URL を設定し、認証は空のままにします。
2. サーバーはステートレスです——セッションヘッダー、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 ツールの設定からサーバーを削除してください。こちら側には何も保存していないので、他に取り消すものはありません。

---

Postal code data © GeoNames contributors, CC BY 4.0.