mcpField
I
imagedimensions-mcp

imagedimensions-mcp

ローカル
github.com/Bishop81開発ツール011 週間前に更新
リポジトリ

imagedimensions-mcp について

imagedimensions-mcpは、公開Webページの画像パフォーマンスを監査する開発者向けMCPサーバーです。ローカルブラウザーを使わず、サーバー側で画像の実寸と表示寸法、過大画像、形式を調べます。

主な機能

  1. 01実寸と表示寸法の比較
  2. 02過大画像の検出
  3. 03画像形式の内訳表示
  4. 04画像の総数と表示数の集計
  5. 05モダン形式の割合表示

活用シーン

  1. 01ページ内の過大画像の特定
  2. 02開発時の画像形式の確認
  3. 03画像によるLCP遅延の可能性の調査

MCP 対応

MCPクライアントにscan_image_dimensionsツールを提供します。公開ページのURLをサーバー側でスキャンし、テキストレポートと構造化データを返します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "bishop81-imagedimensions": {
      "command": "npx",
      "args": [
        "-y",
        "imagedimensions-mcp"
      ],
      "env": {
        "IMAGEDIMENSIONS_API_BASE": "<IMAGEDIMENSIONS_API_BASE>"
      }
    }
  }
}
起動コマンドnpx -y imagedimensions-mcp
設定が必要な環境変数
IMAGEDIMENSIONS_API_BASEOverride the scan API base. Defaults to https://imagedimensions.com.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmimagedimensions-mcp0.1.2

ツール

1

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
urlstringはい監査するページの公開 URL。
oversizedThresholdnumberいいえ画像をサイズ過大と判定する面積超過率のしきい値。デフォルトは 4（各寸法で約 2 倍）です。

詳細

imagedimensions-mcp

あらゆる公開ウェブページ上の画像を監査するMCPサーバーです — 自然サイズとレンダリングサイズの比較、サイズ超過画像の検出、フォーマットの内訳を確認できるため、AI エージェント （Claude、Cursor、Windsurf など）は開発中に画像のパフォーマンスをチェックできます。

imagedimensions.comを利用しています。スキャンはサーバー側で実行されるため、ローカルのブラウザーや Chrome のインストールは不要です。

インストール／実行

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

ツール

scan_image_dimensions
パラメーター型説明
urlstring（必須）監査対象ページの公開 URL。
oversizedThresholdnumber（任意）サイズ超過として検出する面積の超過比率。デフォルトは4（各辺で約2倍）。

テキストレポートと構造化コンテンツを返します。

  • 画像の合計数／表示数と CSS 背景画像の数
  • モダンフォーマット（WebP + AVIF）の割合
  • フォーマットの内訳
  • サイズ超過画像の一覧（自然サイズ → レンダリングサイズ、超過比率、フォーマット、src）
  • imagedimensions.com の完全なビジュアルレポートへのリンク

エージェントでの使用例：「https://example.com の画像を監査して」「このページで LCP に悪影響を与えているサイズ超過画像はどれ？」「このサイトの画像のうち、モダンフォーマットを使っている割合は？」

「サイズ超過」が重要な理由

表示領域よりもはるかに大きい画像をダウンロードすると、帯域幅を無駄にし、Largest Contentful Paint を遅くします。これはウェブ上で最もよくある画像パフォーマンスの問題です。詳しくはこちらの解説をご覧ください。

設定

  • IMAGEDIMENSIONS_API_BASE — API のベース URL を上書きします（デフォルトはhttps://imagedimensions.com）。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。