MLIT Data Platform MCP Server

Instructions

            使い方:
            - 基本: dataset_id と data_id を指定して、そのデータに紐づくサムネイルURL一覧を取得します。
            - ファイル個別のサムネイルが欲しい場合は、search/data 結果から取得した file の id を使って絞り込みます（GraphQLの fileID に相当）。
            - 本ツールは2通りに対応:
            (A) thumbnails=[{id, original_path}, ...] を直接渡す（既にファイル情報を持っている場合に高速）
            (B) dataset_id と data_id を渡す（ツール側で対象データのサムネイルを探索）

            例:
            - データIDからサムネイルのURL一覧を取得:
            dataset_id="ndm", data_id="<searchで取得したid>"

            - 特定ファイルのサムネイルを取得（直接指定）:
            thumbnails=[{ id:"<fileのid>", original_path:"<元ファイルの相対パス>" }]

            注意:
            - 取得したURLが download ドメインで始まる場合は **60秒以内にダウンロード開始**が必要です（期限切れに注意）。
            - サムネイルが存在しないデータは **空配列** が返ります。
            - fileID を指定しない場合はデータに紐づく代表サムネイル等が返ります。必要に応じてファイルIDで絞り込んでください。
            - レスポンスは配列で、各要素は fileName / URL を含みます（GraphQL: thumbnailURLs）。

Implementation Reference

• src/server.py:1463-1471 (handler)

  The handler for get_thumbnail_urls calls MLITClient.thumbnail_urls or thumbnail_urls_from_data depending on if thumbnails were provided.

  elif name == "get_thumbnail_urls":
      p = ThumbnailURLsInput.model_validate(arguments)
      if p.thumbnails:
          thumbs = [ThumbnailRef(id=t.id, original_path=t.original_path) for t in p.thumbnails]
          data = await client.thumbnail_urls(thumbnails=thumbs)
      else:
          data = await client.thumbnail_urls_from_data(
              dataset_id=str(p.dataset_id), data_id=str(p.data_id)  # type: ignore
          )

• src/client.py:1100-1110 (handler)

  MLITClient implementation for getting thumbnail URLs via the thumbnail_urls method.

  async def thumbnail_urls(self, *, thumbnails: List[ThumbnailRef]) -> Dict[str, Any]:
      if not thumbnails:
          return {"thumbnailURLs": []}
      q = self.build_thumbnail_urls(thumbnails=thumbnails)
      return await self.post_query(q)
  
  async def thumbnail_urls_from_data(self, *, dataset_id: str, data_id: str) -> Dict[str, Any]:
      thumbs = await self.get_data_thumbnails(dataset_id=dataset_id, data_id=data_id)
      if not thumbs:
          return {"thumbnailURLs": []}
      return await self.thumbnail_urls(thumbnails=thumbs)

• src/server.py:1013-1066 (schema)

  Registration of get_thumbnail_urls tool including its schema.

      name="get_thumbnail_urls",
      description="""データのサムネイル画像URLを取得する。取得したURLがhttps://www.mlit-data.jp/download/で始まる場合、URLの有効期限は60秒。
  
          使い方:
          - 基本: dataset_id と data_id を指定して、そのデータに紐づくサムネイルURL一覧を取得します。
          - ファイル個別のサムネイルが欲しい場合は、search/data 結果から取得した file の id を使って絞り込みます（GraphQLの fileID に相当）。
          - 本ツールは2通りに対応:
          (A) thumbnails=[{id, original_path}, ...] を直接渡す（既にファイル情報を持っている場合に高速）
          (B) dataset_id と data_id を渡す（ツール側で対象データのサムネイルを探索）
  
          例:
          - データIDからサムネイルのURL一覧を取得:
          dataset_id="ndm", data_id="<searchで取得したid>"
  
          - 特定ファイルのサムネイルを取得（直接指定）:
          thumbnails=[{ id:"<fileのid>", original_path:"<元ファイルの相対パス>" }]
  
          注意:
          - 取得したURLが download ドメインで始まる場合は **60秒以内にダウンロード開始**が必要です（期限切れに注意）。
          - サムネイルが存在しないデータは **空配列** が返ります。
          - fileID を指定しない場合はデータに紐づく代表サムネイル等が返ります。必要に応じてファイルIDで絞り込んでください。
          - レスポンスは配列で、各要素は fileName / URL を含みます（GraphQL: thumbnailURLs）。""",
      inputSchema={
          "type": "object",
          "properties": {
              "thumbnails": {
                  "type": "array",
                  "items": {
                      "type": "object",
                      "properties": {
                          "id": {
                              "type": "string",
                              "description": "サムネイルID"
                          },
                          "original_path": {
                              "type": "string",
                              "description": "元のファイルパス"
                          }
                      },
                      "required": ["id", "original_path"]
                  },
                  "description": "取得するサムネイルの配列"
              },
              "dataset_id": {
                  "type": "string",
                  "description": "データセットID"
              },
              "data_id": {
                  "type": "string",
                  "description": "データID"
              },
          },
      },
  ),