korean-data-mcp

Instructions

Implementation Reference

• src/korean_data_mcp/server.py:90-109 (handler)

  The handler function `get_melon_chart` which uses `_run_actor` to call the `melon-chart-scraper` Apify actor to fetch music chart data.

  @mcp.tool()
  async def get_melon_chart(
      chart_type: str = "realtime",
      limit: int = 100,
  ) -> list[dict]:
      """
      Fetch the Melon music chart (멜론 차트).
  
      Args:
          chart_type: Chart to fetch — 'realtime' (실시간), 'hot100', 'daily', or 'weekly'
          limit: Number of songs to return (default 100, max 100)
  
      Returns:
          List of song objects with rank, title, artist, album fields.
      """
      limit = min(limit, 100)
      return await _run_actor(
          f"{APIFY_ACCOUNT}/melon-chart-scraper",
          {"chartType": chart_type, "limit": limit},
      )