Postio — UK Address, Postcode, Email & Phone Validation

@postio/mcp

Model Context Protocol 服务，适用于 Postio——英国的地址、电子邮件和电话号码验证 API，可作为工具提供给任何兼容 MCP 的 AI 宿主。

第一次使用？ 免费注册——前 100 次查询免费，无需信用卡。

可与 Claude Desktop、Claude Code、Cursor、Windsurf、Zed、 Continue 以及其他任何通过 stdio 使用 MCP 的产品配合使用。

Node 20+。

安装

实际上不需要安装。只需在宿主的 MCP 配置中使用 npx。

Claude Code

claude mcp add postio --env POSTIO_API_KEY=pk_… -- npx -y @postio/mcp

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "postio": {
      "command": "npx",
      "args": ["-y", "@postio/mcp"],
      "env": { "POSTIO_API_KEY": "pk_…" }
    }
  }
}

Cursor

~/.cursor/mcp.json（或项目级配置文件 <project>/.cursor/mcp.json）：

{
  "mcpServers": {
    "postio": {
      "command": "npx",
      "args": ["-y", "@postio/mcp"],
      "env": { "POSTIO_API_KEY": "pk_…" }
    }
  }
}

Windsurf / Zed / Continue

使用与 Cursor 相同的 JSON 配置——它们都采用标准的 MCP 服务配置格式。

工具

工具	功能	是否计费
postio_address_search	自由格式的英国地址搜索 → 建议结果 + UDPRN	否
postio_postcode_lookup	查询邮政编码对应的所有 PAF 投递点	是（命中时）
postio_udprn_lookup	查询单个 UDPRN 的完整记录	是（命中时）
postio_email_validate	语法 + 拼写错误 + MX + SMTP + 分类	是
postio_phone_validate	解析 + 实时 HLR 查询（运营商、是否已转网、是否可接通）	是
postio_connect	免费健康状态探测	否

这些工具刻意保持基础，并与 API 一一对应。Agent 会决定何时串联调用它们——典型的地址查找流程是 postio_address_search → 选择一个 UDPRN → 调用 postio_udprn_lookup 获取完整记录。

每个工具都会以 JSON 文本形式返回原始 API 响应，其中包含用于支持问题追踪的 meta.requestId。

示例提示词

“查找 UDPRN 为 25742215 的地址。” → 调用 postio_udprn_lookup，参数为 udprn=25742215

“查找 W1G 邮政区 Wimpole Street 上的地址。” → 调用 postio_address_search，参数为 query="Wimpole Street W1G"

“[email protected] 是有效的电子邮件地址吗？” → 调用 postio_email_validate，参数为 email="[email protected]" → 响应中包含 didYouMean: "gmail.com"。

“验证这些英国电话号码，并告诉我哪些是手机号码。” → 对每个号码调用 postio_phone_validate。

配置

环境变量	用途
POSTIO_API_KEY	**必填。**你的 Postio API 密钥。
POSTIO_BASE_URL	可选，用于覆盖 API 基础 URL（默认值为 https://api.postio.co.uk/v1）。

缺少 POSTIO_API_KEY 不会导致服务无法启动——服务仍会启动并公布其工具，因此宿主可以在你配置凭据前列出这些工具。随后，单独的调用会失败，并提示你设置密钥。

官方 MCP Registry

已列入 registry.modelcontextprotocol.io，名称为 uk.co.postio/postcode-address-validation，发布在经过域名验证的命名空间下（而非个人 GitHub 命名空间）。

curl "https://registry.modelcontextprotocol.io/v0.1/servers/uk.co.postio%2Fpostcode-address-validation/versions/latest"

该条目根据此目录中的 server.json 生成；其中的版本与此软件包的版本一致。CI（publish-mcp-registry.yml）会在内容变更时重新发布。

许可证

MIT。