AJ

atushi1841/japan-geospatial-open-data-mcp

Developer tools
0 stars 0 forks Quality 81 Trend 20MIT

Japan Geospatial Open Data MCP — GSI tiles/geocoding, e-Stat statistics, MLIT school district GIS (schools, real estate, hazards). No keys for core tools.

Overview

日本全国規模のジオスパティアル・オープンデータを AI エージェントに届ける MCP Server。 GSI 地理院タイル・地理院住所検索・e-Stat 統計 API・国土数値情報(小学校区)・不動産情報ライブラリを 1 つの MCP でまとめて公開する。 FOSS4G Hiroshima 2026 発表「Building an MCP Server Ecosystem on Japan's National-Scale Geospatial Open Data Platform」(Mami Enomoto, MLIT) が示した方向性に追従するエコシステム構築タスク。 不動産分析(学区・用途地域)・教育インフラ評価・防災・都市計画。 GSI/e-Stat/国土数値情報は公式オープンデータ・再利用自由。 - ESTAT_APP_ID — e-Stat application ID (free: https://www.e-stat.go.jp/api/) - REINFOLIB_API_KEY — MLIT Real Estate Information Library API key (application: https://www.reinfolib.mlit.go.jp/) - USER_AGENT — override default User-Agent string - 「東京都渋谷区の小学校区はどれか」 → geocode_japan("東京都渋谷区") → list_school_districts - 「渋谷区の航空写真 2024 年をズーム 15 で表示」 → get_gsi_tile(layer="nendophoto2024", lat=35.657, lon=139.698, z=15) - 「日本の 2020 年人口(年齢別)」 → get_estat_data(table_key="population") - 「地価公示ポイントの GeoJSON」 → (future: get_reinfolib_xkt004 系) when using GSI tiles, include "Geospatial Information Authority of Japan" in your output.

README

japan-geospatial-open-data-mcp

日本全国規模のジオスパティアル・オープンデータを AI エージェントに届ける MCP Server。 GSI 地理院タイル・地理院住所検索・e-Stat 統計 API・国土数値情報(小学校区)・不動産情報ライブラリを 1 つの MCP でまとめて公開する。

Context: FOSS4G Hiroshima 2026 発表「Building an MCP Server Ecosystem on Japan’s National-Scale Geospatial Open Data Platform」(Mami Enomoto, MLIT) が示した方向性に追従するエコシステム構築タスク。 Needs: 不動産分析(学区・用途地域)・教育インフラ評価・防災・都市計画。 TOS: GSI/e-Stat/国土数値情報は公式オープンデータ・再利用自由。

Tools (7)

Tool Description Key required
geocode_japan 住所 → 緯度経度(GSI 住所検索 API, msearch.gsi.go.jp) No
get_gsi_tile 地理院 XYZ タイル(std/pale/blank/aerial/vector)を base64 画像で取得 No
list_data_sources アクセス可能な全データソース一覧と鍵要件 No
get_estat_data e-Stat 統計データ取得(人口・人口動態・世帯 etc.) ESTAT_APP_ID
get_estat_meta e-Stat 統計表メタ情報取得 ESTAT_APP_ID
list_school_districts 全国小学校区 (A27) GML/GeoJSON ファイル一覧(国土数値情報, nlftp.mlit.go.jp) No
get_school_district_geojson 小学校区 GIS タイル (XKT004) GeoJSON 取得(不動産情報ライブラリ) REINFOLIB_API_KEY

Environment variables (optional)

No keys → core GSI + school district listing still works out of the box.

Install

git clone https://github.com/atushi1841/japan-geospatial-open-data-mcp
cd japan-geospatial-open-data-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

Claude Desktop config

{
  "mcpServers": {
    "japan-geospatial-open-data": {
      "command": "/path/to/japan-geospatial-open-data-mcp/.venv/bin/python",
      "args": ["/path/to/japan-geospatial-open-data-mcp/src/server.py"],
      "env": {
        "ESTAT_APP_ID": "your-e-stat-app-id",
        "REINFOLIB_API_KEY": "your-reinfolib-key"
      }
    }
  }
}

Example queries

  • 「東京都渋谷区の小学校区はどれか」 → geocode_japan("東京都渋谷区") → list_school_districts
  • 「渋谷区の航空写真 2024 年をズーム 15 で表示」 → get_gsi_tile(layer="nendophoto2024", lat=35.657, lon=139.698, z=15)
  • 「日本の 2020 年人口(年齢別)」 → get_estat_data(table_key="population")
  • 「地価公示ポイントの GeoJSON」 → (future: get_reinfolib_xkt004 系)

Data sources & licensing

Source URL License
GSI tiles & geocoder https://maps.gsi.go.jp/ GSI tile terms (free, credit required)
e-Stat API https://www.e-stat.go.jp/api/ Open statistics (free, key registration)
MLIT Kokuto Suuchi Jhouhou https://nlftp.mlit.go.jp/ksj/ MLIT open data (free)
MLIT Real Estate Information Library https://www.reinfolib.mlit.go.jp/ MLIT open data (free, application)

Credit requirement: when using GSI tiles, include “Geospatial Information Authority of Japan” in your output.

MCP Registry

Publishing to the official MCP Registry is a follow-up task. The mcp-publisher CLI (GitHub auth, io.github.atushi1841/japan-geospatial-open-data-mcp namespace) is the standard flow.

Roadmap / future tools

  • 用途地域 (zoning) GeoJSON from reinfolib
  • 洪水浸水想定区域 / 土砂災害警戒区域 hazard layers (reinfolib)
  • 地価公示 point API
  • e-Stat 250m mesh population for density analysis
  • 中学校区 (A28) listing
  • Bulk GeoJSON download helper for nlftp files (A27 prefecture-level GML)
View this README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide

Configuration

{ "mcpServers": { "japan-geospatial-open-data": { "command": "/path/to/japan-geospatial-open-data-mcp/.venv/bin/python", "args": ["/path/to/japan-geospatial-open-data-mcp/src/server.py"], "env": { "ESTAT_APP_ID": "your-e-stat-app-id", "REINFOLIB_API_KEY": "your-reinfolib-key" } } } }