mcp-image-reader

An MCP server that reads image files and returns them as base64-encoded content for visual analysis by LLMs.

Requirements

• Python 3.10+
• uv

Installation

git clone <repo-url>
cd mcp-image-reader
uv sync

MCP Configuration

Add to your .kiro/settings/mcp.json (or equivalent MCP client config):

{
  "mcpServers": {
    "image-reader": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/mcp-image-reader", "mcp-image-reader"],
      "autoApprove": ["read_image"]
    }
  }
}

Tools

read_image

Reads an image file and returns it as base64-encoded content.

| Parameter | Type | Description | |-----------|------|-------------| | path | str | Absolute or relative path to the image file |

Supported formats: JPEG, PNG, GIF, WebP.