mcp-server-zipcode-jp

This is a Model Context Protocol (MCP) server for searching Japanese zip codes. It uses the zipcloud zip code search API to retrieve address information.

Features

• Search for address information using Japanese zip codes (7 digits)

• Compliant with the Model Context Protocol (MCP)

Related MCP server: Brazilian ZIP Code Lookup

Installation

npm install
npm run build

Configuration

Using with Claude Desktop

Add the following configuration to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).

{
  "mcpServers": {
    "zipcode-jp": {
      "command": "node",
      "args": ["/path/to/mcp-server-zipcode-jp/build/index.js"]
    }
  }
}

• Please replace /path/to/mcp-server-zipcode-jp with the actual path where you cloned this project.

Available Tools

search_zip_code

Searches for address information from a zip code.

Arguments:

• zipCode (string): 7-digit zip code (supports both with and without hyphens)

Response Example:

{
  "results": [
    {
      "address1": "東京都",
      "address2": "新宿区",
      "address3": "西新宿",
      "kana1": "ﾄｳｷｮｳﾄ",
      "kana2": "ｼﾝｼﾞｭｸｸ",
      "kana3": "ﾆｼｼﾝｼﾞｭｸ",
      "prefcode": "13",
      "zipcode": "1600023"
    }
  ],
  "status": 200,
  "message": null
}

Development

Build

npm run build

License

ISC