# PostcodeDog MCP Server

**ค้นหาและตรวจสอบรหัสไปรษณีย์จากเครื่องมือ AI ของคุณ**

เชื่อม Claude, ChatGPT, Codex, Cursor, VS Code และเครื่องมือ AI อื่น ๆ กับ PostcodeDog ค้นรหัสไปรษณีย์ใน 82 ประเทศ ตรวจสอบตามรูปแบบของแต่ละประเทศ และแยกที่อยู่ได้จากผู้ช่วยของคุณ

Endpoint: https://postcode.dog/mcp

Streamable HTTP · ไม่ต้องสมัคร · ไม่ต้องใช้ API key

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

## ทำอะไรได้บ้าง

ถามด้วยภาษาธรรมชาติ ผู้ช่วยจะเลือกเครื่องมือที่เหมาะสมให้

### ค้นหาและตรวจสอบ

ค้นรหัสไปรษณีย์ เมือง หรือชื่อสถานที่ใน 82 ประเทศ และตรวจรหัสตามรูปแบบของประเทศก่อนใส่ลงในที่อยู่

- 90210 คือที่ไหน และมีประเทศใดใช้รหัสเดียวกันอีก?
- 75008 เป็นรหัสไปรษณีย์ฝรั่งเศสที่ถูกต้องหรือไม่?
- ชิบูย่า โตเกียว ใช้รหัสไปรษณีย์อะไร?
- ค้นมิวนิกในเยอรมนีและแสดงรหัสไปรษณีย์สามรหัส

### ขอบเขตข้อมูล

ดูว่าประเทศใดมีข้อมูล ใช้รูปแบบใด และข้อมูลละเอียดแค่ไหนในแต่ละประเทศ

- คุณครอบคลุมประเทศใดในยุโรป และใช้รูปแบบอะไร?
- รหัสไปรษณีย์ของอังกฤษและแคนาดาเป็นแบบไหน?
- ฐานข้อมูลมีรหัสไปรษณีย์กี่รายการ?
- แสดงรายชื่อประเทศที่ครอบคลุมในเอเชีย พร้อมตัวอย่างรหัสประเทศละหนึ่งรหัส

### จัดการที่อยู่

แยกที่อยู่เต็มออกเป็นประเทศ ภูมิภาค เมือง และรหัสไปรษณีย์ แล้วยืนยันว่ารหัสนั้นมีอยู่จริงก่อนใช้ในฟอร์มหรือใบปะหน้า

- แยกที่อยู่ 1 Infinite Loop, Cupertino, CA 95014, USA
- รหัสไปรษณีย์ของ 10 Downing Street, London คืออะไร?
- ตรวจรหัสเยอรมนีเหล่านี้ทีละรหัส: 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 key — แค่ 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

เครื่องมือ AI ใดก็ตามที่รองรับ MCP ระยะไกลผ่าน Streamable HTTP เชื่อมต่อได้ด้วย URL นี้ ไม่มีขั้นตอน OAuth และไม่ต้องลงทะเบียนไคลเอนต์

`mcp.json`

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

1. ตั้งค่าไคลเอนต์ให้ชี้ไปที่ URL ของเซิร์ฟเวอร์ และเว้นการยืนยันตัวตนว่างไว้
2. เซิร์ฟเวอร์ไม่มีสถานะ — ไม่ต้องมี session header ไม่มีคุกกี้ ไม่ต้อง handshake initialize

**ลองตรวจสอบ:** ถามว่า “90210 คือที่ไหน?”

## คำถาม

### PostcodeDog MCP server คืออะไร?

เชื่อมเครื่องมือ AI เช่น Claude, ChatGPT, Cursor และ Codex เข้ากับฐานข้อมูลรหัสไปรษณีย์ของ PostcodeDog ผ่าน Model Context Protocol ผู้ช่วยค้นรหัส ค้นสถานที่ ตรวจรูปแบบของแต่ละประเทศ แยกที่อยู่ และบอกขอบเขตข้อมูลได้

### ต้องใช้ API key หรือไม่?

ไม่ต้อง เซิร์ฟเวอร์เป็นแบบสาธารณะและอ่านอย่างเดียว ไม่มีบัญชี ไม่มี OAuth ไม่มีโทเคน วาง URL ก็เสร็จ

### ใช้กับเครื่องมือ AI อะไรได้บ้าง?

เครื่องมือใดก็ตามที่รองรับ MCP ระยะไกลผ่าน Streamable HTTP คู่มือนี้ครอบคลุม Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp และ opencode

### ผู้ช่วยเห็นข้อมูลอะไรได้บ้าง?

เฉพาะข้อมูลไปรษณีย์สาธารณะ ประมาณ 1.8 ล้านแถวจาก GeoNames ใน 82 ประเทศ มีชื่อสถานที่ ภูมิภาค อำเภอ พิกัด และรูปแบบของแต่ละประเทศ ไม่มีบัญชี จึงไม่มีข้อมูลส่วนบุคคล

### มันแก้ไขอะไรได้ไหม?

ไม่ได้ เครื่องมือทั้งห้าเป็นแบบอ่านอย่างเดียว เขียน ส่ง หรือแก้ไขข้อมูลไม่ได้ ไม่ตั้งคุกกี้ และไม่เก็บเซสชัน

### ข้อมูลแม่นยำแค่ไหน?

เป็นฐานข้อมูลรหัสไปรษณีย์ของ GeoNames ภายใต้สัญญาอนุญาต CC BY 4.0 อัปเดตทุกครั้งที่สร้างใหม่ ชื่อสถานที่และพิกัดมาจากบันทึกจริง ความละเอียดแตกต่างกันในแต่ละประเทศ โดย list_countries จะบอกรูปแบบและขอบเขตที่มีให้ของแต่ละประเทศ

### มีข้อจำกัดอัตราการเรียกหรือไม่?

ไม่มีคีย์และไม่มีโควต้าแข็ง แต่ PostcodeDog เป็นเว็บเล็ก ๆ งานแบบกลุ่มควรจำกัดความถี่ หากใช้ปริมาณมากหรือเชิงพาณิชย์ กรุณาติดต่อก่อน

### จะยกเลิกการเชื่อมต่ออย่างไร?

ลบเซิร์ฟเวอร์ออกจากการตั้งค่าเครื่องมือ AI ฝั่งเราไม่เก็บข้อมูลใด ๆ จึงไม่มีอะไรต้องเพิกถอนเพิ่ม

---

Postal code data © GeoNames contributors, CC BY 4.0.
