Skip to main content
Glama
MasaBigBrother

jp-address-mcp

README.md
# Japanese Address Normalizer & Verifier (MCP Server)

An MCP server that normalizes and verifies Japanese postal addresses.
Splits messy Japanese address strings (full-width characters, mixed
hyphens, romaji, building/room names) into structured fields, with a
verification flag and lat/lng.

Built for AI agents doing cross-border commerce, logistics, or CRM
involving Japan.

## Endpoint (remote, no install)

Streamable HTTP:https://jp-addr.streamfront.net/mcp
## Tool

### `normalize_jp_address`
Structure & verify a raw Japanese address string.

**Input**: `{ "address": "東京都新宿区西新宿2-8-1 パークタワー1503号" }`

**Output** (example):
```json
{
  "ok": true,
  "normalized": {
    "pref": "東京都", "city": "新宿区", "town": "西新宿二丁目",
    "banchi": "8-1", "building": "パークタワー", "room": "1503"
  },
  "geo": { "lat": 35.68945, "lng": 139.691774 },
  "level": 3, "verified": true
}
```

## How it works
Wraps the open-source `@geolonia/normalize-japanese-addresses` engine and
adds a preprocessing/structuring layer: full-width→half-width, hyphen
normalization, chome/banchi boundary detection via engine metadata,
building & room separation, and a verification flag.

## Status
Early. Single tool. Tested mainly on residential/urban addresses.
Feedback welcome.

## Registry
Published to the official MCP Registry as `net.streamfront/jp-address`.

TDQS

A4.4/5.0

Scored across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusion. The tool's purpose is unambiguous and clearly described.

Naming Consistency5/5

The single tool name follows a clear verb_noun pattern (normalize_jp_address), which is predictable and consistent with common conventions.

Tool Count3/5

With only one tool, the server feels minimal for a dedicated address utility. It earns its place, but the scope is thin and borderline.

Completeness5/5

The tool consolidates parsing, verification, and geocoding into one operation, covering the full address normalization workflow. There are no obvious gaps for the stated purpose.

Maintenance

ActivitySlowing
ResponsivenessNo issues