GeoServer MCP Server

Instructions

Args:
    layers: List of layers to include (format: workspace:layer)
    styles: Optional styles to apply (one per layer)
    bbox: Bounding box [minx, miny, maxx, maxy]
    width: Image width in pixels
    height: Image height in pixels
    format: Image format (png, jpeg, etc.)

Returns:
    Dict with map information and URL

Implementation Reference

• src/geoserver_mcp/main.py:371-451 (handler)

  The core handler function for the 'generate_map' MCP tool. Decorated with @mcp.tool() for registration. Constructs a WMS GetMap request URL using the provided layers, styles, bounding box, and rendering parameters, returning a dictionary with the map URL and parameters.

  @mcp.tool()
  def generate_map(
      layers: List[str],
      styles: Optional[List[str]] = None,
      bbox: Optional[List[float]] = None,
      width: int = 800,
      height: int = 600,
      format: str = "png"
  ) -> Dict[str, Any]:
      """Generate a map image using WMS GetMap.
      
      Args:
          layers: List of layers to include (format: workspace:layer)
          styles: Optional styles to apply (one per layer)
          bbox: Bounding box [minx, miny, maxx, maxy]
          width: Image width in pixels
          height: Image height in pixels
          format: Image format (png, jpeg, etc.)
      
      Returns:
          Dict with map information and URL
      """
      geo = get_geoserver()
      if geo is None:
          raise ValueError("Not connected to GeoServer")
      
      if not layers:
          raise ValueError("At least one layer must be specified")
      
      # Validate parameters
      if styles and len(styles) != len(layers):
          raise ValueError("Number of styles must match number of layers")
      
      if not bbox:
          bbox = [-180, -90, 180, 90]  # Default to global extent
      
      if len(bbox) != 4:
          raise ValueError("Bounding box must have 4 coordinates: [minx, miny, maxx, maxy]")
      
      # Valid formats
      valid_formats = ["png", "jpeg", "gif", "tiff", "pdf"]
      if format.lower() not in valid_formats:
          raise ValueError(f"Invalid format. Must be one of: {', '.join(valid_formats)}")
      
      try:
          # Construct WMS GetMap URL
          url = f"{geo.service_url}/wms"
          params = {
              "service": "WMS",
              "version": "1.3.0",
              "request": "GetMap",
              "format": f"image/{format}",
              "layers": ",".join(layers),
              "width": width,
              "height": height,
              "crs": "EPSG:4326",
              "bbox": ",".join(map(str, bbox))
          }
          
          # Add styles if provided
          if styles:
              params["styles"] = ",".join(styles)
              
          # Construct the full URL
          import urllib.parse
          query_string = urllib.parse.urlencode(params)
          map_url = f"{url}?{query_string}"
          
          return {
              "url": map_url,
              "width": width,
              "height": height,
              "format": format,
              "layers": layers,
              "styles": styles,
              "bbox": bbox
          }
      except Exception as e:
          logger.error(f"Error generating map: {str(e)}")
          raise ValueError(f"Failed to generate map: {str(e)}")