# Japan Area Code MCP Server

A Model Context Protocol (MCP) server that provides access to Japanese
statistical standard area codes (標準地域コード). This server fetches data from
the official Japanese government CSV file and provides tools to list and search
area codes.

## Installation

1. Clone or download this repository
2. Install dependencies:
   ```bash
   npm install
   ```
3. Build the project:
   ```bash
   npm run build
   ```

## Configuration

To use this MCP server with Cursor or other MCP-compatible clients, add it to
your MCP configuration file (typically `~/.cursor/mcp.json`):

```json
{
    "mcpServers": {
        "japan-areacode-mcp": {
            "command": "node",
            "args": ["/path/to/japan-areacode-mcp/dist/index.js"]
        }
    }
}
```

Make sure to replace `/path/to/japan-areacode-mcp` with the actual path to this
project.

## Usage

The server provides two tools: `list-areacode` and `find-areacode`

### Tool: `list-areacode`

Lists all area codes from the official Japanese government CSV file.

#### Parameters

None

### Tool: `find-areacode`

Finds an area code by searching for a prefecture or municipality name.

#### Parameters

| Parameter | Type   | Required | Description                                                                 |
| --------- | ------ | -------- | --------------------------------------------------------------------------- |
| `query`   | string | Yes      | Search query that can match prefecture name, municipality name, or yomigana |

## References

- [Statistical standard area code](https://www.soumu.go.jp/toukei_toukatsu/index/seido/9-5.htm)
- Data source: `https://www.soumu.go.jp/main_content/000323625.csv`