acuris-mcp-server

Acuris MCP 服务

适用于 Acuris 地址验证与地理编码 API 的模型上下文协议服务。将 Acuris 接入 Claude Desktop、Claude Code、Cursor 或任何支持 MCP 的客户端，即可让你的 Agent 使用四种地址工具：

工具	功能
validate_address	验证 240 多个国家/地区的任何邮政地址。返回标准化地址、屋顶级坐标、可信度评分（A-F），以及英国的 UDPRN 和 UPRN。
postcode_lookup	输入英国邮政编码，返回该编码下的所有 Royal Mail PAF 投递点。
geocode	将地址转换为纬度和经度。
reverse_geocode	将经纬度转换为最近的已知地址。

快速开始

在 api.acuris-geo.com/register 获取免费 API 密钥（100 次免费验证、100 次免费地理编码，有效期 7 天，无需信用卡）。

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "acuris": {
      "command": "npx",
      "args": ["-y", "@acuris-geo/mcp-server"],
      "env": { "ACURIS_API_KEY": "acu_…" }
    }
  }
}

重启 Claude Desktop。四种工具会显示在“Acuris”服务下。

Claude Code

claude mcp add acuris -e ACURIS_API_KEY=acu_… -- npx -y @acuris-geo/mcp-server

Cursor / Codex / 任何 MCP 客户端

该服务使用纯 stdio MCP。将客户端指向：

ACURIS_API_KEY=acu_… npx -y @acuris-geo/mcp-server

示例提示词

安装后，试试：

验证此地址：10 Downing Street, London, SW1A 2AA

查找英国邮政编码 M1 1AD 下的所有地址

柏林 Reichstag 的屋顶坐标是什么？

51.5036, -0.1277 对应什么地址？

Agent 会选择合适的工具并调用它，然后将 JSON 结果读给你。

为什么要使用 MCP 服务？

目前没有其他英国／欧盟地址验证服务提供商（Ideal Postcodes、Loqate、Smarty、postcoder、getaddress.io）提供 MCP 服务。如果你的团队使用 Agentic IDE 构建应用，Acuris 是唯一提供一流集成的 AV 服务提供商。

API 接口

该服务会调用：

• POST https://api.acuris-geo.com/validate
• POST https://api.acuris-geo.com/postcode-lookup （GBR — 内部代理到 paf.acuris-geo.com）
• GET https://api.acuris-geo.com/geocode
• GET https://api.acuris-geo.com/reverse

英国请求会自动路由到我们的 PAF 卫星服务（paf.acuris-geo.com），授权使用的 Royal Mail PAF 数据集托管于此。调用方无需了解这一点。

开发

npm install
npm run build
ACURIS_API_KEY=test node dist/index.js   # smoke-test with the public test key

许可证

MIT。源代码：https://github.com/Acuris-GmbH/acuris-mcp-server.