acuris-mcp

Acuris Geo MCP 服务

让任何 AI Agent——Claude、Cursor、ChatGPT、Gemini CLI 以及所有其他支持 MCP 的客户端——直接、自描述地访问 Acuris 地址验证和地理编码：覆盖 240 多个国家/地区，提供明确的 verified / corrected / 部分匹配判定；英国地址通过官方 Royal Mail PAF 验证（UDPRN + UPRN）；为街道级精确匹配的美国/加拿大地址提供免费的普查和地理信息补充（包括普查区、普查分组、FIPS、CBSA/MSA、国会选区、学区，以及加拿大对应的数据）。

该服务只是构建在 Acuris REST API 之上的薄层：每次工具调用的计费、退款和速率限制都与其封装的 API 调用完全一致，并使用你自己的 API 密钥。查找失败会自动退款——只为结果付费，不为尝试付费。

快速开始 — 托管端点（推荐，无需安装）

Claude Code

claude mcp add --transport http acuris-geo https://api.acuris-geo.com/mcp \
  --header "Authorization: Bearer YOUR_ACURIS_API_KEY"

Claude Desktop / 任意 JSON 配置客户端

{
  "mcpServers": {
    "acuris-geo": {
      "type": "http",
      "url": "https://api.acuris-geo.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_ACURIS_API_KEY" }
    }
  }
}

Cursor（.cursor/mcp.json）

{ "mcpServers": { "acuris-geo": {
    "url": "https://api.acuris-geo.com/mcp",
    "headers": { "Authorization": "Bearer YOUR_ACURIS_API_KEY" } } } }

还没有 API 密钥？ 无需密钥即可连接，然后使用你的电子邮件调用 request_trial_key 工具——即可立即获得免费试用密钥（100 点额度，有效期 7 天，无需银行卡，无需填写注册表单）。然后使用该密钥重新连接。

工具

工具	功能	费用
validate_address	验证并标准化单个地址（覆盖 240 多个国家/地区；英国地址通过 Royal Mail PAF 验证，提供 UDPRN + UPRN）。街道级精确的美国/加拿大地址匹配结果包含免费的普查信息补充数据块。	1 点额度
validate_addresses_batch	每次调用最多处理 50 个地址，可混合不同国家/地区。结果顺序与输入顺序一致。	每行 1 点额度
enrich_us_ca_address	地址 → 普查区、普查分组、县/州 FIPS、CBSA/MSA、国会选区、学区（美国）/传播区、普查分区、CMA/CA、联邦选区（加拿大）。	1 点额度（信息补充免费）
geocode_address	正向地理编码；每项结果都会明确标注 accuracy_type。	1 点额度
reverse_geocode	坐标 → 最近的地址及其距离。	1 点额度
expand_uk_postcode	英国邮政编码 → 所有 Royal Mail 投递点（机构、UDPRN、UPRN、屋顶坐标）。	每个邮政编码 1 点额度
check_balance	查看已连接密钥的剩余点额度。	免费
request_trial_key	通过电子邮件立即获取免费试用密钥（24 小时内幂等）。	免费

未匹配和错误响应会自动退款。

本地（stdio）模式

pip install acuris-mcp        # or: uvx acuris-mcp --stdio
ACURIS_API_KEY=YOUR_KEY acuris-mcp --stdio

Claude Desktop stdio 配置：

{
  "mcpServers": {
    "acuris-geo": {
      "command": "uvx",
      "args": ["acuris-mcp", "--stdio"],
      "env": { "ACURIS_API_KEY": "YOUR_KEY" }
    }
  }
}

工具和计费方式相同。推荐使用托管端点——无需安装，且始终保持最新。

文档和链接

• 完整 MCP 文档：https://api.acuris-geo.com/docs/mcp
• REST API 参考：https://api.acuris-geo.com/docs
• 定价：https://www.acuris-geo.com/acuris-pricing/
• 美国/加拿大信息补充：https://www.acuris-geo.com/us-canada-address-enrichment/
• Excel 加载项（使用相同引擎，无需编写代码）：https://www.acuris-geo.com/excel-add-in/

许可证

MIT（此连接器）。Acuris API 本身是一项商业服务——请参阅条款。