japan-geospatial-open-data-mcp

japan-geospatial-open-data-mcp

为 AI Agent 提供日本全国规模的地理空间开放数据的 MCP 服务。 通过一个 MCP 汇集并公开 GSI 地理院地图瓦片、地理院地址搜索、e-Stat 统计 API、国土数值信息（小学学区）以及不动产信息库。

背景： 这是一个生态系统构建任务，旨在遵循 FOSS4G Hiroshima 2026 演讲《Building an MCP Server Ecosystem on Japan's National-Scale Geospatial Open Data Platform》（Mami Enomoto, MLIT）所提出的方向。 需求： 不动产分析（学区、用途地域）、教育基础设施评估、防灾、城市规划。 使用条款： GSI/e-Stat/国土数值信息均为官方开放数据，可自由再利用。

工具（7 个）

工具	描述	是否需要密钥
geocode_japan	地址 → 经纬度（GSI 地址搜索 API，msearch.gsi.go.jp）	否
get_gsi_tile	获取地理院 XYZ 瓦片（std/pale/blank/aerial/vector），以 base64 图像形式返回	否
list_data_sources	列出所有可访问的数据源及密钥要求	否
get_estat_data	获取 e-Stat 统计数据（人口、人口动态、家庭等）	ESTAT_APP_ID
get_estat_meta	获取 e-Stat 统计表元信息	ESTAT_APP_ID
list_school_districts	列出全国小学学区（A27）GML/GeoJSON 文件（国土数值信息，nlftp.mlit.go.jp）	否
get_school_district_geojson	获取小学学区 GIS 瓦片（XKT004）GeoJSON（不动产信息库）	REINFOLIB_API_KEY

环境变量（可选）

• ESTAT_APP_ID — e-Stat 应用 ID（免费：https://www.e-stat.go.jp/api/）
• REINFOLIB_API_KEY — MLIT 不动产信息库 API 密钥（申请地址：https://www.reinfolib.mlit.go.jp/）
• USER_AGENT — 覆盖默认的 User-Agent 字符串

不设置密钥 → 核心 GSI 功能和学区列表仍可开箱即用。

安装

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 配置

{
  "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"
      }
    }
  }
}

查询示例

• 「东京都涩谷区有哪些小学学区？」 → geocode_japan("東京都渋谷区") → list_school_districts
• 「以缩放级别 15 显示涩谷区 2024 年航空照片」 → get_gsi_tile(layer="nendophoto2024", lat=35.657, lon=139.698, z=15)
• 「日本 2020 年人口（按年龄划分）」 → get_estat_data(table_key="population")
• 「地价公示点的 GeoJSON」 →（未来：get_reinfolib_xkt004 系列）

数据源与许可

来源	URL	许可
GSI 瓦片与地理编码器	https://maps.gsi.go.jp/	GSI 瓦片条款（免费，需注明来源）
e-Stat API	https://www.e-stat.go.jp/api/	开放统计数据（免费，需注册密钥）
MLIT 国土数值信息	https://nlftp.mlit.go.jp/ksj/	MLIT 开放数据（免费）
MLIT 不动产信息库	https://www.reinfolib.mlit.go.jp/	MLIT 开放数据（免费，需申请）

来源标注要求： 使用 GSI 瓦片时，请在输出中注明 “Geospatial Information Authority of Japan”。

MCP Registry

向官方 MCP Registry 发布是后续任务。 mcp-publisher CLI（GitHub 身份验证，io.github.atushi1841/japan-geospatial-open-data-mcp 命名空间）是标准流程。

路线图 / 未来工具

• 从 reinfolib 获取用途地域（分区规划）GeoJSON
• 洪水浸水预想区域 / 土砂灾害警戒区域灾害图层（reinfolib）
• 地价公示点 API
• 用于密度分析的 e-Stat 250 m 网格人口
• 中学学区（A28）列表
• nlftp 文件（A27 都道府县级 GML）的 GeoJSON 批量下载辅助工具

Apify Store

此 MCP 服务已作为 Apify Actor 发布：japan-geospatial-open-data-mcp。

Apify Store：atushi1841

---

数据与商店

• Apify Store： https://apify.com/fruitful_quintessence
• Gumroad 数据集： https://atushi5.gumroad.com/l/kutuxe