MLIT Data Platform MCP Server

Instructions

            使い方:
            - すでに dataSetID / dataID を把握している場合に、軽量にタイトル等の基本情報だけ取得します。
            - 検索結果から拾った id を入れて確認・プレビュー用途に最適。

            例:
            - タイトルだけ確認したい:
            dataset_id="cals_construction", data_id="<searchで取得したid>"

            - 詳細取得前の事前チェック:
            dataset_id="mlit-001", data_id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

            注意:
            - data_id は検索API（search）の結果で得られる DataClass.id を使用してください。
            - 指定したIDに一致しない場合、totalNumber=0 となります（結果なし）。
            - サマリ用途のため、詳細な付帯情報が必要な場合は get_data を使用してください。

Implementation Reference

• src/client.py:742-754 (handler)

  The 'get_data_summary' method in MLITClient defines the GraphQL query and executes it via post_query.

  async def get_data_summary(self, dataset_id: str, data_id: str) -> Dict[str, Any]:
      q = f"""
      query {{
        data(dataSetID: "{dataset_id}", dataID: "{data_id}") {{
          totalNumber
          getDataResults {{
            id
            title
          }}
        }}
      }}
      """.strip()
      return await self.post_query(q)

• src/server.py:339-371 (registration)

  Definition of the 'get_data_summary' tool in the server catalog.

      name="get_data_summary",
      description="""データセットIDとデータIDを用いて、基本情報（データID、タイトル）を取得する。
  
          使い方:
          - すでに dataSetID / dataID を把握している場合に、軽量にタイトル等の基本情報だけ取得します。
          - 検索結果から拾った id を入れて確認・プレビュー用途に最適。
  
          例:
          - タイトルだけ確認したい:
          dataset_id="cals_construction", data_id="<searchで取得したid>"
  
          - 詳細取得前の事前チェック:
          dataset_id="mlit-001", data_id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  
          注意:
          - data_id は検索API（search）の結果で得られる DataClass.id を使用してください。
          - 指定したIDに一致しない場合、totalNumber=0 となります（結果なし）。
          - サマリ用途のため、詳細な付帯情報が必要な場合は get_data を使用してください。""",
      inputSchema={
          "type": "object",
          "properties": {
              "dataset_id": {
                  "type": "string",
                  "description": "データセットID。searchツールの結果から取得"
              },
              "data_id": {
                  "type": "string",
                  "description": "データID。searchツールの結果から取得"
              }
          },
          "required": ["dataset_id", "data_id"],
      },
  ),

• src/server.py:1304-1307 (handler)

  The handle_call_tool implementation that invokes 'get_data_summary' on the client.

  elif name == "get_data_summary":
      p = GetDataParams.model_validate(arguments)
      data = await client.get_data_summary(p.dataset_id, p.data_id)