Imagedimensions MCP

What Bishop81/imagedimensions-mcp MCP server does

Bishop81/imagedimensions-mcp MCP server gives an MCP client one tool for inspecting image usage on a public web page. The scan_image_dimensions tool accepts a page URL and returns an audit covering image sizing, visibility, CSS backgrounds, and file formats.

The audit compares each image's natural dimensions with the dimensions at which it is rendered. It can identify oversized images whose downloaded area is much greater than their displayed area, a condition that can waste bandwidth and contribute to slower Largest Contentful Paint. The report also shows the proportion of images using modern formats and provides a format-by-format breakdown.

How it works

Bishop81/imagedimensions-mcp MCP server sends the requested page to the hosted imagedimensions.com service for analysis. Processing occurs server-side rather than in the local MCP client environment. As a result, the client does not need Chrome, a browser automation setup, or a locally installed browser.

The tool returns both a text report and structured results. These include total and visible image counts, the number of CSS-background images, modern-format share, format details, and oversized-image entries. Each oversized entry includes natural and rendered dimensions, an overshoot ratio, the image format, and its source URL. The response also includes a link to the complete visual report on imagedimensions.com.

Setup and configuration

Run the server through npx using the package name imagedimensions-mcp:

{
  "mcpServers": {
    "imagedimensions": {
      "command": "npx",
      "args": ["-y", "imagedimensions-mcp"]
    }
  }
}

This configuration can be used with Claude Desktop or another MCP client that supports local stdio servers. The server uses https://imagedimensions.com as its default API base. Set IMAGEDIMENSIONS_API_BASE to point to a different API base when an override is needed.

Tools and capabilities

scan_image_dimensions requires one parameter:

• url: The public page URL to inspect.

It also accepts an optional oversizedThreshold number. The default is 4, representing an area-overshoot ratio of roughly two times per dimension. Increasing or decreasing this value changes which images are flagged as oversized.

Bishop81/imagedimensions-mcp MCP server supports these practical checks:

• Compare downloaded image size with rendered size.
• Find images that may be oversized for their layout boxes.
• Count total and visible images.
• Include CSS-background image counts.
• Measure WebP and AVIF usage.
• Review the full format distribution.

Limitations and notes

The tool is intended for public web pages, so it is not described as a solution for authenticated, private, or locally hosted pages. Results depend on the hosted imagedimensions.com API and the page being reachable for server-side scanning. The oversized-image result is threshold-based; the default does not necessarily match every team's performance policy. The project is licensed under MIT.