Skip to main content
Glama
mcp-server-zipcode-jp

mcp-server-zipcode-jp

by tanish-kr

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: jpzip MCP server

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

Available Tools

1 tool
search_zip_codeC

Search zip code data

Inputs: zipCode (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no risk of ambiguity. The single tool's purpose is clear and distinct by default.

    Naming Consistency5/5

    The single tool name 'search_zip_code' follows a consistent verb_noun pattern, which is clear and predictable.

    Tool Count3/5

    A single tool for a zip code server feels minimal. While search might be sufficient, the scope is thin compared to typical CRUD or lookup services for zip codes.

    Completeness2/5

    The tool surface appears incomplete for a comprehensive zip code service. Missing operations like get_by_code, reverse lookup, or list prefectures limit the agent's ability to perform related tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables to look up Japanese postal codes, convert zipcodes to addresses, search addresses by query, and list cities in a prefecture using the jpzip dataset.
      4
      7 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables ZIP and postal code lookups—resolving codes to city, state, and coordinates for 60+ countries, and fetching all postal codes for a city—via the Zippopotam.us API.
      131 npm
      MIT