MCPでのデータアクセス

Geospect は、人間向けのマップ・カタログに加えて、AIエージェントが公開カタログを読み取り専用で扱えるMCPサーバーを提供しています。MCP対応クライアントから接続して利用してください。

このMCPは、公式データの再配布API、任意範囲の抽出API、継続的な時系列配信、ライセンスや権利の最終判断を提供するものではありません。正式な取得、加工、再配布、商用利用、業務判断では、必ず公式提供元のページ、規約、ライセンス、仕様を確認してください。

MCPのインターフェース

MCP対応クライアントから、Geospect の公開カタログを読み取り専用で検索・確認できます。エンドポイントは https://mcp.geospect.jp/mcp。次の2つのツールを提供しており、接続したクライアントは各ツールの入力項目をMCP経由で取得します。

search_datasets

地域、分野、キーワードから公開カタログ内のデータセット候補を探します。

レスポンス例

{
  "mcp_interface_version": "2026-06-18.draft",
  "catalog_generated_at": "2026-06-25T00:00:00Z",
  "notices": [
    {
      "kind": "rights",
      "message": "License and usage conditions are not interpreted by Geospect MCP. Check official provider links."
    }
  ],
  "total_count": 42,
  "results": [
    {
      "dataset_id": "PoTM",
      "title": "（データセット名）",
      "summary": "（概要）",
      "provider": { "provider_id": "mlit_ksj", "name": "国土数値情報" },
      "geospect_links": {
        "catalog_url": "https://geospect.jp/catalog/PoTMtPkM",
        "map_url": "https://geospect.jp/map?layers=PoTMtPkM"
      },
      "official_links": {
        "dataset_page_url": "https://…",
        "distribution_page_url": "https://…"
      }
    }
  ],
  "next_cursor": null
}

get_dataset_detail

データセットの概要、公式リンク、利用上の注意、属性項目、関連するマップ導線を確認します。

レスポンス例

{
  "mcp_interface_version": "2026-06-18.draft",
  "catalog_generated_at": "2026-06-25T00:00:00Z",
  "notices": [{ "kind": "rights", "message": "…" }],
  "geospect_links": {
    "catalog_url": "https://geospect.jp/catalog/PoTMtPkM",
    "map_url": "https://geospect.jp/map?layers=PoTMtPkM"
  },
  "dataset": {
    "dataset_id": "PoTM",
    "title": "（データセット名）",
    "summary": "（概要）",
    "provider": { "provider_id": "mlit_ksj", "name": "国土数値情報" },
    "categories": ["人口・世帯"],
    "spatial_units": ["都道府県"],
    "record_count": 1234,
    "data_size_label": "約 2 MB",
    "formats": ["GeoJSON", "PMTiles"],
    "source_updated_at": "2025-04-01",
    "checked_at": "2026-06-20"
  },
  "official_links": {
    "dataset_page_url": "https://…",
    "distribution_page_url": "https://…"
  },
  "layers": [
    {
      "layer_id": "PoTMtPkM",
      "title": "（レイヤ名）",
      "style": "fill",
      "map_url": "https://geospect.jp/map?layers=PoTMtPkM"
    }
  ],
  "attributes_summary": {
    "field_count": 12,
    "inline_fields": [
      {
        "field_name": "P01_001",
        "display_name": "総人口",
        "description": "（属性の説明）",
        "completeness_rate": 0.98
      }
    ]
  }
}

MCPの設定

MCP対応クライアントでリモートMCPサーバーを追加できる場合は、次のURLを指定してください。設定形式はクライアントによって異なります。

Codex

codex mcp add geospect --url https://mcp.geospect.jp/mcp

Claude Code

claude mcp add --transport http geospect https://mcp.geospect.jp/mcp