Back to Browse

Imagedimensions MCP Server

Developer ToolsModerate6.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

6.2
Moderate6.2Moderate Risk

Well-structured MCP server with clean code, proper error handling, and appropriate security controls. The server makes authenticated API calls to imagedimensions.com and processes user-provided URLs without dangerous operations. Minor code quality observations noted but do not impact security posture. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

6 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Override the scan API base. Defaults to https://imagedimensions.com.Optional

Environment variable: IMAGEDIMENSIONS_API_BASE

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-bishop81-imagedimensions-mcp": {
      "env": {
        "IMAGEDIMENSIONS_API_BASE": "your-imagedimensions-api-base-here"
      },
      "args": [
        "-y",
        "imagedimensions-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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

// 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

Reviews

No reviews yet

Be the first to review this server!