Enhanced ADB MCP Server

Instructions

Implementation Reference

• src/adb_mcp_server/server.py:100-134 (handler)

  Main handler function for the 'get_screen_specs' tool. Uses ADB to fetch screen size and density, parses outputs, calculates DP equivalents, aspect ratio, and density classification. The @mcp.tool() decorator registers it as an MCP tool.

  @mcp.tool()
  def get_screen_specs(device_serial: str | None = None) -> dict:
      """Get detailed screen specifications - useful for responsive design"""
      size_output = run_adb(["shell", "wm", "size"], device_serial)
      density_output = run_adb(["shell", "wm", "density"], device_serial)
      
      # Parse physical size
      size_match = re.search(r'Physical size: (\d+)x(\d+)', size_output)
      override_match = re.search(r'Override size: (\d+)x(\d+)', size_output)
      
      width, height = 0, 0
      if override_match:
          width, height = int(override_match.group(1)), int(override_match.group(2))
      elif size_match:
          width, height = int(size_match.group(1)), int(size_match.group(2))
      
      # Parse density
      density = 0
      density_match = re.search(r'Physical density: (\d+)', density_output)
      if density_match:
          density = int(density_match.group(1))
      
      # Calculate useful metrics
      dp_width = (width / density) * 160 if density else 0
      dp_height = (height / density) * 160 if density else 0
      
      return {
          "width_px": width,
          "height_px": height,
          "density_dpi": density,
          "width_dp": round(dp_width, 1),
          "height_dp": round(dp_height, 1),
          "aspect_ratio": f"{width}:{height}",
          "density_bucket": get_density_bucket(density)
      }

• src/adb_mcp_server/server.py:137-144 (helper)

  Supporting helper function called by get_screen_specs to classify screen density into standard Android buckets (ldpi, mdpi, hdpi, etc.).

  def get_density_bucket(dpi: int) -> str:
      """Map DPI to Android density bucket"""
      if dpi <= 120: return "ldpi"
      if dpi <= 160: return "mdpi"
      if dpi <= 240: return "hdpi"
      if dpi <= 320: return "xhdpi"
      if dpi <= 480: return "xxhdpi"
      return "xxxhdpi"

• src/adb_mcp_server/server.py:100-100 (registration)

  The @mcp.tool() decorator registers the get_screen_specs function as an MCP tool with the name matching the function name.

  @mcp.tool()