Korea Tourism API MCP Server

Instructions

Implementation Reference

• src/mcp_tourism/server.py:884-937 (handler)

  The implementation of the get_tourism_images tool handler.

  async def get_tourism_images(
      content_id: str,
      language: str | None = None,
      page: int = 1,
      rows: int = 20,
  ) -> dict:
      """
      Get images for a specific tourism item in Korea.
  
      This tool retrieves all available images for a specific tourism item by its
      content ID. It provides both original and thumbnail image URLs along with
      image metadata.
  
      Args:
          content_id (str): Content ID of the tourism item (obtained from other search functions)
          language (str, optional): Language for results (default: "en"). Supported:
              - "en" (English)
              - "jp" (Japanese)
              - "zh-cn" (Simplified Chinese)
              - "zh-tw" (Traditional Chinese)
              - "de" (German)
              - "fr" (French)
              - "es" (Spanish)
              - "ru" (Russian)
          page (int, optional): Page number for pagination (default: 1, min: 1)
          rows (int, optional): Number of items per page (default: 20, max: 100)
  
      Returns:
          dict: Images with structure:
          {
              "total_count": int,     # Total number of matching items
              "content_id": str,      # Content ID this image belongs to
              "items": [              # List of image items
                  {
                      "contentid": str,       # Content ID this image belongs to
                      "imgname": str,         # Image name
                      "originimgurl": str,    # URL of original image
                      "smallimageurl": str,   # URL of small/thumbnail image
                      "serialnum": str,       # Serial number
                      "cpyrhtDivCd": str      # Copyright division code
                  }
                  # ... more items
              ]
          }
  
      Example:
          get_tourism_images("126508", "en", 1, 10)
      """
      # Call the API client and return dict directly
      results = await get_api_client().get_detail_images(
          content_id=content_id, language=language, page=page, rows=rows
      )
      # Add content_id to the results
      return {**results, "content_id": content_id}

• src/mcp_tourism/server.py:883-884 (registration)

  Registration of the get_tourism_images tool using the @mcp.tool decorator.

  @mcp.tool
  async def get_tourism_images(