e-Stat MCP

Instructions

Implementation Reference

• e_stats_mcp/tools/dataset.py:11-43 (handler)

  The core handler function for the 'post_dataset' tool. It constructs parameters from inputs and makes an asynchronous POST request to the e-Stat API's 'postDataset' endpoint to register the dataset.

  async def post_dataset(
      dataset_name: str,
      stats_data_id: str,
      conditions: dict | None = None,
      description: str | None = None,
  ) -> dict:
      """データセットを登録する.
  
      Args:
          dataset_name: データセット名
          stats_data_id: 統計表ID
          conditions: 取得条件（cdCatXX, cdTime, cdArea などを辞書で指定）
          description: 説明文
  
      Returns:
          登録結果
      """
      params = {
          "datasetName": dataset_name,
          "statsDataId": stats_data_id,
      }
      if description:
          params["description"] = description
      if conditions:
          params.update(conditions)
  
      response = await _make_request(
          "postDataset",
          params,
          method="POST",
          data=params,
      )
      return cast(dict[str, Any], response)

• e_stats_mcp/main.py:54-54 (registration)

  Registers the 'post_dataset' function as an MCP tool using the FastMCP decorator mcp.tool().

  mcp.tool()(post_dataset)