PostcodeDog MCP ServerTra cứu và kiểm tra mã bưu chính ngay trong công cụ AI
Kết nối Claude, ChatGPT, Codex, Cursor, VS Code và các công cụ AI khác với PostcodeDog. Tra mã bưu chính ở 82 quốc gia, kiểm tra theo định dạng từng nước và tách địa chỉ ngay trong trợ lý.
https://postdog.zhangjunrock.workers.dev/mcpBạn có thể làm gì
Hỏi bằng ngôn ngữ tự nhiên. Trợ lý sẽ chọn đúng công cụ.
Tra cứu và kiểm tra
Tìm mã bưu chính, thành phố hoặc địa danh ở 82 quốc gia, và kiểm tra mã theo định dạng quốc gia trước khi đưa vào địa chỉ.
- 90210 là ở đâu, và những nước nào dùng cùng mã đó?
- 75008 có phải mã bưu chính hợp lệ của Pháp không?
- Shibuya, Tokyo dùng mã bưu chính nào?
- Tra Munich ở Đức và cho tôi ba mã bưu chính.
Phạm vi dữ liệu
Xem nước nào có dữ liệu, dùng định dạng gì và độ chi tiết của dữ liệu từng nước.
- Bạn bao phủ những nước châu Âu nào và dùng định dạng gì?
- Mã bưu chính Anh và Canada trông như thế nào?
- Cơ sở dữ liệu có bao nhiêu mã bưu chính?
- Liệt kê các nước được bao phủ ở châu Á, kèm một mã ví dụ cho mỗi nước.
Xử lý địa chỉ
Tách một địa chỉ đầy đủ thành quốc gia, vùng, thành phố và mã bưu chính, rồi xác nhận mã tồn tại trước khi dùng trong biểu mẫu hoặc nhãn vận chuyển.
- Tách địa chỉ 1 Infinite Loop, Cupertino, CA 95014, USA.
- Mã bưu chính của 10 Downing Street, London là gì?
- Kiểm tra từng mã Đức này: 10115, 80331, 99999.
- Kiểm tra SW1A 1AA và cho tôi biết nó bao khu vực nào của London.
Cài đặt
Chọn công cụ AI của bạn. Không cần đăng nhập, không cần API key — chỉ cần URL máy chủ.
Claude Code
claude mcp add --transport http --scope user postcodedog https://postdog.zhangjunrock.workers.dev/mcp- Chạy lệnh trong terminal.
- Mở Claude Code, chạy /mcp và chọn postcodedog.
Thử kiểm tra: hỏi “90210 là ở đâu?”
Codex
codex mcp add postcodedog --url https://postdog.zhangjunrock.workers.dev/mcp[mcp_servers.postcodedog]
url = "https://postdog.zhangjunrock.workers.dev/mcp"- Thêm máy chủ bằng lệnh, hoặc thêm khối vào ~/.codex/config.toml.
- Mở Codex. Không có bước đăng nhập — máy chủ công khai.
Thử kiểm tra: hỏi “Beverly Hills 90210 dùng mã bưu chính nào?”
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"
}
}
}- Thêm máy chủ bằng lệnh, hoặc thêm khối vào cài đặt Gemini CLI.
- Mở Gemini CLI và chạy /mcp để xác nhận postcodedog đã kết nối.
Thử kiểm tra: hỏi “75008 có phải mã bưu chính hợp lệ của Pháp không?”
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"
}
}
}- Chạy lệnh, hoặc lưu khối thành .vscode/mcp.json trong workspace.
- Mở khung MCP, khởi động postcodedog và hỏi một câu về mã bưu chính.
Thử kiểm tra: hỏi “Định dạng mã bưu chính của Đức và Nhật là gì?”
Cursor
{
"mcpServers": {
"postcodedog": {
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Gộp khối vào ~/.cursor/mcp.json, hoặc .cursor/mcp.json trong dự án.
- Mở cài đặt Cursor → MCP, bật postcodedog rồi tải lại cửa sổ.
Thử kiểm tra: hỏi “Bạn bao phủ những nước châu Âu nào?”
Claude
https://postdog.zhangjunrock.workers.dev/mcp- Mở Customize → Connectors, chọn Add → Custom → Web.
- Đặt tên PostcodeDog, dán URL máy chủ và để trống phần xác thực.
- Chọn Connect — công cụ dùng được ngay, không cần đăng nhập.
Thử kiểm tra: hỏi “Tách địa chỉ 1 Infinite Loop, Cupertino, CA 95014, USA.”
ChatGPT
https://postdog.zhangjunrock.workers.dev/mcp- Mở Plugins, chọn +, rồi Add custom MCP server.
- Đặt tên PostcodeDog, dán URL và chọn “No authentication”.
- Tạo plugin và hỏi một câu về mã bưu chính trong cuộc trò chuyện mới.
Thử kiểm tra: hỏi “Mã bưu chính của Shibuya, Tokyo là gì?”
Amp
amp mcp add postcodedog https://postdog.zhangjunrock.workers.dev/mcp- Chạy lệnh.
- Amp kết nối ngay lần đầu dùng; không có bước đăng nhập.
Thử kiểm tra: hỏi “99999 có tồn tại ở Đức không?”
opencode
opencode mcp add postcodedog --global --url https://postdog.zhangjunrock.workers.dev/mcp- Thêm máy chủ.
- Mở opencode và hỏi về mã bưu chính; không cần xác thực.
Thử kiểm tra: hỏi “Nước Mỹ có bao nhiêu nơi tên Springfield?”
Other AI tools
Bất kỳ công cụ AI nào hỗ trợ máy chủ MCP từ xa qua Streamable HTTP đều kết nối được bằng URL này. Không có luồng OAuth và không cần đăng ký client.
{
"mcpServers": {
"postcodedog": {
"type": "http",
"url": "https://postdog.zhangjunrock.workers.dev/mcp"
}
}
}- Trỏ client tới URL máy chủ và để trống xác thực.
- Máy chủ không trạng thái — không cần header phiên, không cookie, không handshake initialize.
Thử kiểm tra: hỏi “90210 là ở đâu?”
Câu hỏi
Máy chủ MCP PostcodeDog là gì?
Nó kết nối các công cụ AI như Claude, ChatGPT, Cursor và Codex với cơ sở dữ liệu mã bưu chính của PostcodeDog qua Model Context Protocol. Trợ lý có thể tra mã, tìm địa danh, kiểm tra theo định dạng quốc gia, tách địa chỉ và cho biết phạm vi dữ liệu.
Có cần API key không?
Không. Máy chủ công khai và chỉ đọc: không tài khoản, không OAuth, không token. Dán URL là xong.
Dùng được với công cụ AI nào?
Mọi công cụ hỗ trợ máy chủ MCP từ xa qua Streamable HTTP. Hướng dẫn này gồm Claude Code, Codex, Gemini CLI, VS Code, Cursor, Claude, ChatGPT, Amp và opencode.
Trợ lý thấy được gì?
Chỉ dữ liệu bưu chính công khai: khoảng 1,8 triệu dòng GeoNames ở 82 quốc gia, gồm tên địa danh, vùng, hạt, toạ độ và định dạng quốc gia. Không có tài khoản nên không có dữ liệu cá nhân.
Nó có thay đổi gì không?
Không. Cả năm công cụ đều chỉ đọc. Máy chủ không ghi, không gửi, không sửa dữ liệu, không đặt cookie và không lưu phiên.
Dữ liệu có chính xác không?
Đây là cơ sở dữ liệu mã bưu chính GeoNames, giấy phép CC BY 4.0, cập nhật mỗi lần dựng lại. Tên địa danh và toạ độ lấy từ bản ghi thật. Độ chi tiết khác nhau theo từng nước; list_countries cho biết định dạng và phạm vi có sẵn của từng nước.
Có giới hạn tần suất không?
Không có key và không có hạn mức cứng, nhưng PostcodeDog là site nhỏ: giữ tốc độ xử lý hàng loạt ở mức hợp lý. Dùng nhiều hoặc thương mại thì liên hệ trước.
Làm sao ngắt kết nối?
Xoá máy chủ trong cài đặt công cụ AI. Phía chúng tôi không lưu gì nên không còn gì để thu hồi.