# Bishop81/imagedimensions-mcp [Health: Active]

**Category:** 🔒 Security  
**Repository:** https://github.com/Bishop81/imagedimensions-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 381  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bishop81-imagedimensions-mcp

## Description
Audit the images on any web page: natural vs rendered dimensions, oversized-image detection, and format breakdown, so agents can check web-image performance. Calls the hosted imagedimensions.com API, so no local browser is required. npx -y imagedimensions-mcp

## Tools
Capabilities this server exposes over MCP:

- **scan_image_dimensions** — Audit the images on any public web page. Returns each image's natural vs rendered dimensions, flags oversized images (downloaded much larger than displayed — a common Largest Contentful Paint problem), and breaks down formats (WebP/AVIF adoption). Useful for web performance and image-optimization work.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "imagedimensions-mcp": {
    "command": "npx",
    "args": ["-y","imagedimensions-mcp"],
    "env": {
      "IMAGEDIMENSIONS_API_BASE": ""
    }
  }
}
```

**Requires environment variables:** `IMAGEDIMENSIONS_API_BASE` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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`:

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/bishop81-imagedimensions-mcp/readme_