acuris-mcp-server

Acuris MCP サーバー

Acuris Address Validation & Geocoding API 用のModel Context Protocolサーバーです。Acuris を Claude Desktop、Claude Code、Cursor、または MCP 対応クライアントに接続すると、エージェントが次の 4 つの住所ツールを利用できるようになります。

ツール	機能
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 を再起動します。4 つのツールが「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 にある住所をすべて検索してください

ベルリンの国会議事堂の屋上座標は何ですか？

51.5036, -0.1277 にある住所は何ですか？

エージェントが適切なツールを選択して呼び出し、JSON の結果を読み取って返します。

MCP サーバーを使う理由

現在、英国／EU の住所検証プロバイダー（Ideal Postcodes、Loqate、Smarty、postcoder、getaddress.io）のうち、MCP サーバーを提供しているところはありません。エージェント型 IDE を使ってチームで開発している場合、一流の統合機能を提供している住所検証プロバイダーは Acuris だけです。

API の概要

サーバーは次の 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

英国のリクエストは、ライセンスを受けた Royal Mail PAF データセットが保存されている PAF サテライト（paf.acuris-geo.com）に自動的にルーティングされます。呼び出し元がこれを把握する必要はありません。

開発

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。