MLIT Data Platform MCP Server

Instructions

            使い方:
            - キーワード検索（同義語も対象）: term="橋梁"
            - 完全一致で絞り込み: term="橋梁", phrase_match=True
            - ページング取得: first=0, size=50  ※APIの上限は一度に最大10,000件
            - 並べ替え: sort_attribute_name="DPF:updated_at", sort_order="dsc"（降順）/ "asc"（昇順）
            - 軽量レスポンス: minimal=True（主要フィールドのみ取得）

            例:
            - バス停を検索: term="バス停"
            - 橋梁を新しい更新順で取得: term="橋梁", sort_attribute_name="DPF:updated_at", sort_order="dsc"
            - ページ2相当を取得: term="道路", first=50, size=50

            注意:
            - API仕様上、term=""（空文字）でも検索は可能ですが、空間条件（矩形/円）やメタデータ条件を使った絞り込みは本ツールでは扱いません。
            空間検索は「search_by_location_rectangle / search_by_location_point_distance」、
            メタデータ検索は「search_by_attribute」を利用してください。
            - sort_order は "asc" または "dsc" を指定してください。
            - 大量件数を扱う場合はページング（first/size）を利用してください。

Implementation Reference

• src/server.py:1234-1244 (handler)

  The "search" tool handler logic, which validates input parameters and calls `client.search_keyword`.

  if name == "search":
      p = SearchBase.model_validate(arguments)
      data = await client.search_keyword(
          term=p.term or "",
          first=p.first,
          size=p.size,
          phrase_match=p.phrase_match,
          sort_attribute_name=p.sort_attribute_name,
          sort_order=p.sort_order,
          fields=client._fields_min() if p.minimal else client._fields_basic(),
      )

• src/server.py:51-110 (registration)

  The definition and registration of the "search" tool in the `handle_list_tools` function.

  types.Tool(
      name="search",
      description="""キーワードを使って検索する。検索結果の並べ替えや取得件数を設定することも可能。
  
          使い方:
          - キーワード検索（同義語も対象）: term="橋梁"
          - 完全一致で絞り込み: term="橋梁", phrase_match=True
          - ページング取得: first=0, size=50  ※APIの上限は一度に最大10,000件
          - 並べ替え: sort_attribute_name="DPF:updated_at", sort_order="dsc"（降順）/ "asc"（昇順）
          - 軽量レスポンス: minimal=True（主要フィールドのみ取得）
  
          例:
          - バス停を検索: term="バス停"
          - 橋梁を新しい更新順で取得: term="橋梁", sort_attribute_name="DPF:updated_at", sort_order="dsc"
          - ページ2相当を取得: term="道路", first=50, size=50
  
          注意:
          - API仕様上、term=""（空文字）でも検索は可能ですが、空間条件（矩形/円）やメタデータ条件を使った絞り込みは本ツールでは扱いません。
          空間検索は「search_by_location_rectangle / search_by_location_point_distance」、
          メタデータ検索は「search_by_attribute」を利用してください。
          - sort_order は "asc" または "dsc" を指定してください。
          - 大量件数を扱う場合はページング（first/size）を利用してください。""",
      inputSchema={
          "type": "object",
          "properties": {
              "term": {
                  "type": "string",
                  "description": "検索キーワード。属性フィルタ(prefecture_code等)のみで検索する場合は空文字列\"\"を設定してください"
              },
              "first": {
                  "type": "integer",
                  "default": 0,
                  "description": "検索結果の開始位置(オフセット)。ページネーションに使用"
              },
              "size": {
                  "type": "integer",
                  "default": 50,
                  "description": "取得件数(最大500)。大量データの場合はget_all_dataを使用してください"
              },
              "sort_attribute_name": {
                  "type": "string",
                  "description": "ソート属性名 (例: 'DPF:year', 'DPF:title')"
              },
              "sort_order": {
                  "type": "string",
                  "description": "ソート順序: 'asc'(昇順) または 'dsc'(降順)"
              },
              "phrase_match": {
                  "type": "boolean",
                  "default": True,
                  "description": "フレーズマッチ。true=完全一致優先, false=部分一致"
              },
              "minimal": {
                  "type": "boolean",
                  "default": False,
                  "description": "最小限のフィールドのみ返す(id, title, lat, lon, dataset_id)"
              },
          },
      },
  ),