English Français العربية

io.github.Bishop81/imagedimensions-mcp

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package imagedimensions-mcp
Claude Code 
claude mcp add imagedimensions-mcp -e 'IMAGEDIMENSIONS_API_BASE=<IMAGEDIMENSIONS_API_BASE>' -- npx -y imagedimensions-mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "imagedimensions-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "imagedimensions-mcp@0.1.2"
            ],
            "env": {
                "IMAGEDIMENSIONS_API_BASE": "<IMAGEDIMENSIONS_API_BASE>"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. imagedimensions-mcp
  2. Install / run
  3. Tool
  4. Why "oversized" matters
  5. Config
  6. License

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

الأسئلة الشائعة

ما هو io.github.Bishop81/imagedimensions-mcp؟

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

كيف أثبّت io.github.Bishop81/imagedimensions-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add imagedimensions-mcp -e 'IMAGEDIMENSIONS_API_BASE=<IMAGEDIMENSIONS_API_BASE>' -- npx -y imagedimensions-mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Bishop81/imagedimensions-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.Bishop81/imagedimensions-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Bishop81/imagedimensions-mcp؟

ينشره Bishop81. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.