mcp-image-tools

MCP server providing image analysis tools for AI agents. Metadata inspection only -- no image processing or manipulation.

Tools

image_metadata

Read image metadata from a URL using HTTP headers. Returns content-type, file size, last-modified, etag, and cache info without downloading the full image.

find_favicons

Find all favicons for any website. Checks /favicon.ico, parses HTML <link> tags, and inspects manifest.json. Returns all discovered favicons with sizes and types.

extract_og_image

Extract Open Graph image, Twitter card image, and Apple touch icon from any URL. Useful for generating link previews.

generate_placeholder

Generate placeholder image URLs via the placehold.co API. Supports custom dimensions, colors, text, format, and font. Returns the URL plus ready-to-use HTML and Markdown markup. Can generate multiple sizes at once.

responsive_images

Generate srcset and <picture> element HTML for responsive images. Given a base image URL, produces multiple size variants with proper markup for responsive design, including multi-format <source> elements.

Setup

npm install
npm run build

Usage with Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "image-tools": {
      "command": "node",
      "args": ["path/to/mcp-image-tools/dist/index.js"]
    }
  }
}

License

MIT