About image
mcp-image-tools is an MCP server for AI agents that need image-related metadata and web image references. It inspects image headers, locates site icons and social preview images, and generates placeholder URLs and responsive-image markup.
Key features
- 01Read image metadata from headers
- 02Find website favicons
- 03Extract social preview images
- 04Generate placeholder image URLs
- 05Create responsive image markup
Use cases
- 01Check image type, size, and cache details
- 02Find icons for a website
- 03Collect images for link previews
- 04Prepare responsive image HTML
MCP support
It exposes image inspection and markup-generation tools to MCP clients. The tools cover metadata, favicons, Open Graph and card images, placeholders, and responsive image markup.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
5Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Direct URL to an image file |
Details
From the project READMEmcp-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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.