Imagedimensions Mcp

io.github.Bishop81Published by GitHub account Bishop81v0.1.2Updated Oct 25, 2026

Audit a web page's images: natural vs rendered sizes, oversized detection, and formats.

VerifiedSTDIODesktop onlyWeb Search & ScrapingDeveloper Tools

Overview

AI-generated overview

An MCP server that audits the images on a public web page, reporting natural versus rendered sizes, oversized images and format breakdown.

What you can do
Scan a public page URL and get a text report plus structured results on its images, with an optional threshold for flagging oversized images. Review total and visible image counts, CSS-background counts, modern-format share and a format breakdown. List oversized images with natural and rendered sizes, overshoot ratio, format and source, plus a link to a full visual report.
When to use it
Useful during front-end or performance work when you want an assistant to check whether a page's images are oversized or poorly formatted, for example when investigating Largest Contentful Paint.
Requirements
Runs locally via npx, so Node.js is needed. The scan is performed server-side by imagedimensions.com, so network access is required and no local browser is needed. The optional IMAGEDIMENSIONS_API_BASE variable overrides the API base.
Before you install
Page URLs you submit are sent to the third-party imagedimensions.com service for scanning, so avoid auditing private or internal pages. The tool only reads public pages and does not modify them. The optional API base override points the server at a different endpoint, which should be trusted.

Installation

In SourceWeft

  1. Open Imagedimensions Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

imagedimensions-mcp

An MCP server that audits the images on any public web page — natural vs. rendered dimensions, oversized-image detection, and format breakdown — so AI agents (Claude, Cursor, Windsurf, etc.) can check image performance during development.

Powered by imagedimensions.com. The scan runs server-side, so no local browser or Chrome install is required.

Install / run

jsonc
// Claude Desktop / any MCP client config{  "mcpServers": {    "imagedimensions": {      "command": "npx",      "args": ["-y", "imagedimensions-mcp"]    }  }}

Tool

scan_image_dimensions

ParamTypeDescription
urlstring (required)Public URL of the page to audit.
oversizedThresholdnumber (optional)Area-overshoot ratio to flag as oversized. Default 4 (≈2× per dimension).

Returns a text report plus structured content:

  • total / visible image counts and CSS-background count
  • modern-format share (WebP + AVIF)
  • format breakdown
  • the list of oversized images (natural → rendered, overshoot ratio, format, src)
  • a link to the full visual report on imagedimensions.com

Example agent uses: "Audit the images on https://example.com," "Which images on this page are oversized and hurting LCP?", "What % of this site's images use modern formats?"

Why "oversized" matters

An image downloaded much larger than the box it renders into wastes bandwidth and slows Largest Contentful Paint — the most common image-performance mistake on the web. See the writeup.

Config

  • IMAGEDIMENSIONS_API_BASE — override the API base (default https://imagedimensions.com).

License

MIT

Source: README.md at commit 832a88c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts