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
- Clone or download this repository
- Install dependencies:
npm install - Build the project:
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):
{
"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
- Data source:
https://www.soumu.go.jp/main_content/000323625.csv