Japan Area Code MCP Server

# 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`