Japan Places MCP Server
Japan Places API용 MCP 서버 — 1,917개 지방자치단체의 인구조사 데이터(2020년 인구조사), 47개 모든 도도부현의 POI 카테고리별 개수, 역세권, 일본의 파생 실시간 신호 13종을 제공합니다. 도구 16개. 무료 도구는 데이터를 직접 반환하고, 유료 데이터셋은 HTTP 402로 응답합니다(Base의 x402 USDC / RapidAPI Premium).
호스팅형 MCP 서버
npx add-mcp 'https://japan-places.local-connect-design.trade/mcp'Claude Code, Codex, Cursor 등에 설치됩니다
문서
Japan Places MCP Server
MCP server for the Japan Places API — municipality census for 1,917 municipalities (2020 census), POI category counts for all 47 prefectures, station catchments, and 13 derived live signals for Japan.
Install
npm install mcp-japan-places
npx mcp-japan-places
Or with a custom endpoint:
JAPAN_PLACES_BASE=https://japan-places.local-connect-design.trade npx mcp-japan-places
The server is zero-dependency (Node >= 18, stdio JSON-RPC) and holds no API keys and no payment credentials.
Tools
16 tools: the same set as the hosted MCP (the canon in
functions/mcp-tools.json) — one per dataset.
Free tools return data directly. Paid tools are gated by the API with
HTTP 402 (x402 micropayments in USDC on Base, or a RapidAPI Premium Datasets
plan on PRO/ULTRA/MEGA); without payment a paid tool returns a clean,
labelled PAID_DATASET error explaining the price and the payment routes —
this server cannot pay on your behalf.
| Tool | Endpoint | Access |
|---|---|---|
jp_municipality | GET /api/v1/poi/municipality | Free |
jp_quality | GET /api/v1/poi/quality | Free |
jp_catchment | GET /api/v1/poi/catchment | Paid, US$0.05/call |
jp_chains | GET /api/v1/poi/chains | Paid, US$0.03/call |
jp_aliveness | GET /api/v1/poi/aliveness | Paid, US$0.02/call |
jp_density | GET /api/v1/poi/density | Paid, US$0.05/call |
jp_energy_price | GET /api/v1/signals/energy/price | Paid, US$0.05/call |
jp_land_price | GET /api/v1/poi/land/price | Paid, US$0.05/call |
jp_subsidy_award_rate | GET /api/v1/signals/subsidy/award-rate | Paid, US$0.05/call |
jp_grant_deadline_alert | GET /api/v1/signals/grant/deadline | Paid, US$0.04/call |
jp_gbizinfo_search | GET /api/v1/signals/gbizinfo | Paid, US$0.03/call |
jp_jma_weather | GET /api/v1/signals/jma/weather | Paid, US$0.02/call |
jp_boj_statistics | GET /api/v1/signals/boj/statistics | Paid, US$0.03/call |
jp_tourism_signal | GET /api/v1/signals/tourism | Paid, US$0.02/call |
jp_crime_statistics | GET /api/v1/signals/crime | Paid, US$0.02/call |
jp_facility_signal | GET /api/v1/signals/facility | Paid, US$0.03/call |
Notes:
jp_municipalityrequiresprefecture(name such as東京都or the 2-digit JIS X 0401 code such as13); the API answers 400 without it.jp_catchmentcurrently covers a sample of 60 major stations (a full-station rollout is planned), per the API's own disclosure.- Changed in 2.1.0 (JP-16 canon resync):
jp_health,jp_catalogandjp_history_diffwere removed so this package carries exactly the hosted MCP's 16-tool set./health,/poiand/diff/{dataset}remain available over REST.
Generated code — do not edit by hand
src/index.js is generated by tools/generate_mcp.py from the vendored
inputs in tools/inputs/:
openapi.json— a snapshot of the live OpenAPI spec (https://japan-places.local-connect-design.trade/api/v1/openapi),mcp-tools.json— the tool canon of the site's own hosted MCP,SPEC_SOURCE.json— provenance of the snapshot (source, capture date, catalog hash).
npm run generate # regenerate src/index.js + SYNC.json
npm test # live smoke test against the real API
npm run check-drift # compare the live spec against SYNC.json
SYNC.json records the spec source, the catalog hash this build was
generated from, and the tool/path coverage. Re-running the generator on an
unchanged spec produces a byte-identical tree.
Drift watch (permanent sync loop)
tools/check_drift.py fetches the live /api/v1/openapi, and compares its
catalog hash and path set against SYNC.json (exit 0 = in sync, exit 2 =
drift, with a diff summary). A capture-fleet stream named mcp_drift runs
this checker daily on the sora fleet; a divergence lands in the fleet status
as a failure, which queues the follow-up work item: refresh
tools/inputs/openapi.json from the live spec, re-run the generator, run
the smoke test, and republish. That loop is what keeps this package matched
to the live API.
要約(日本語): 本パッケージの src/index.js は生成物です。ライブAPIの
OpenAPI 仕様とサイト内蔵MCPのツール定義から tools/generate_mcp.py が
生成します。ライブ仕様とのずれは tools/check_drift.py が検出し、soraの
取得フリート(ストリーム mcp_drift、日次)が監視します。ずれたら
「仕様を取り直して再生成、スモークテスト、再公開」が作業項目になります。
License
CDLA-Permissive-2.0 AND Apache-2.0
Data licenses: CDLA-Permissive-2.0, Apache-2.0, CC0-1.0, CC BY 2.0/4.0, PDL-1.0 Attribution: https://japan-places.local-connect-design.trade/jp-places/attribution.html
Publisher
Lexus — https://github.com/lexusdev7