MLIT Data Platform MCP Server

Instructions

            使い方:
            - フィルタなし（既定）: 全国すべての市区町村を返します（大量件数）。
            - 都道府県で絞り込み: pref_codes=["13"] のように都道府県コードを指定（複数可）。
            - 市区町村コードで絞り込み: muni_codes=["13101","13102"] のように6桁コードを指定（複数可）。
            - 取得フィールドを最小化: fields=["code_as_string","name"] のように必要フィールドだけ指定（クライアント最適化）。

            例:
            - 全国の市区町村（コード/名称のみ）:
            pref_codes=[], muni_codes=[], fields=["code_as_string","name"]

            - 東京都の市区町村一覧:
            pref_codes=["13"], fields=["code_as_string","prefecture_code","name","katakana"]

            - 特定の市区町村コードを直接取得:
            muni_codes=["13101","13102"], fields=["code_as_string","name","romaji"]

            注意:
            - GraphQL仕様: `municipalities(muniCodes:[Any], prefCodes:[Any]): [MunicipalityClass]`。
            パラメータ未指定時は**全件**を返します（大量になるため fields での軽量化推奨）。:contentReference[oaicite:1]{index=1}
            - コードは数値/文字列どちらでも指定可能ですが、アプリ側で扱いやすいのは **6桁の文字列** `code_as_string` です（例: "13101"）。:contentReference[oaicite:2]{index=2}
            - 返却クラス `MunicipalityClass` には、`name`（郡名/市区町村名/政令市区名を組み合わせた正式名称）、`katakana`、`romaji`、`prefecture_code`、および有効期間（`used_from`/`used_until`）等が含まれます。:contentReference[oaicite:3]{index=3}
            - 政令指定都市の区は**独立したエントリ**として返ります（例: 札幌市中央区 など）。:contentReference[oaicite:4]{index=4}

Implementation Reference

• src/server.py:1330-1337 (handler)

  The 'get_municipality_data' tool handler, which validates input using Pydantic and then calls the client's 'get_municipalities' method.

  elif name == "get_municipality_data":
      p = GetMunicipalitiesParams.model_validate(arguments)
      data = await client.get_municipalities(
          pref_codes=p.pref_codes,
          muni_codes=p.muni_codes,
          fields=p.fields,
      )

• src/client.py:789-820 (handler)

  The client implementation of 'get_municipalities', which constructs and posts the GraphQL query to retrieve municipality data.

  async def get_municipalities(
      self,
      pref_codes: Optional[List[str]] = None,
      muni_codes: Optional[List[str]] = None,
      *,
      fields: Optional[List[str]] = None,
  ) -> Dict[str, Any]:
      if not pref_codes and not muni_codes:
          raise ValueError("Either pref_codes or muni_codes must be provided")
  
      def q(s: str) -> str:
          return '"' + s.replace('"', '\\"') + '"'
  
      args: List[str] = []
      if pref_codes:
          pref = "[" + ", ".join(q(c) for c in pref_codes) + "]"
          args.append(f"prefCodes: {pref}")
      if muni_codes:
          muni = "[" + ", ".join(q(c) for c in muni_codes) + "]"
          args.append(f"muniCodes: {muni}")
  
      default_fields = ["code_as_string", "prefecture_code", "name"]
      out_fields = " ".join(fields if fields else default_fields)
  
      ql = f"""
      query {{
        municipalities({", ".join(args)}) {{
          {out_fields}
        }}
      }}
      """.strip()
      return await self.post_query(ql)