Image Reader MCP Server

@moiri-gamboni

About Image Reader MCP Server

An MCP (Model Context Protocol) server (using FastMCP) to provide tools for listing local image files and reading their content. Designed for LLM agent integration.

#mcp #cursor #llm #mcp-server #fastmcp

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "imageReader": {
      "command": "npx",
      "args": [
        "image-reader-mcp"
      ],
      "env": {}
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Image Reader MCP Server?

A simple MCP server built with FastMCP that allows listing image files in a specified directory and reading a specific image file to return its content as base64 for display. It is intended for users who need to browse and view local image files through an MCP client.

How to use Image Reader MCP Server?

Configure the server in an MCP client by adding an imageReader entry to the mcpServers object, using the command npx with arguments ["image-reader-mcp"]. Invoke the list_images tool with an absolute directory path to see available images, or the read_image tool with the absolute file path of an image to view its content.

Key features of Image Reader MCP Server

Lists image files in a specified directory.
Reads a specific image file and returns its content as base64.
Supports .jpg, .jpeg, .png, .gif, .bmp, .webp, .svg extensions.
Built with FastMCP and uses an imageContent helper for display.

Use cases of Image Reader MCP Server

Browse image files in a local directory via an MCP client.
View a specific image by reading its file content into the client.

FAQ from Image Reader MCP Server

What image formats are supported?

.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg.

Does the server require any runtime dependencies?

It is run via npx, so Node.js and npm are required.

Where does data live?

All image data is read from local files on the user's filesystem; no remote storage is involved.

Are there any known limitations?

When used with Cursor, the server currently seems to function only when Claude Sonnet is selected, as other models don't appear to have vision enabled.

Frequently asked questions

What image formats are supported?

.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg.

Does the server require any runtime dependencies?

It is run via `npx`, so Node.js and npm are required.

Where does data live?

All image data is read from local files on the user's filesystem; no remote storage is involved.

Are there any known limitations?

When used with Cursor, the server currently seems to function only when Claude Sonnet is selected, as other models don't appear to have vision enabled.

Comments

Basic information

More Media & Design MCP servers

SVGator

Drive your SVGator account from any AI assistant. Prompt an animation, get an editable project back, and export it as SVG, Lottie, GIF, MP4, and more, then open it in the editor to finish by hand.