mcpField
I
Image Reader MCP Server

Image Reader MCP Server

Local
github.com/moiri-gamboniMedia & Design13Updated 77w ago
Repository

About Image Reader MCP Server

Image Reader MCP Server is a FastMCP server for LLM agent workflows that need to browse local image directories and read image content. It lists supported files and returns a selected image as content.

Key features

  1. 01List image files in a directory
  2. 02Read an image and return its content
  3. 03Support JPG, PNG, GIF, BMP, WebP, and SVG

Use cases

  1. 01Let an agent find images in a directory
  2. 02Provide local image content to a vision model

MCP support

The MCP server provides clients with `list_images` and `read_image` tools for listing local image files and reading a selected image.

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "image-reader": {
      "command": "npx",
      "args": [
        "-y",
        "image-reader-mcp"
      ]
    }
  }
}
Run commandnpx -y image-reader-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmimage-reader-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Image Reader MCP Server

A simple MCP server built with FastMCP that provides tools to:

  • List image files in a specified directory.
  • Read a specific image file and return its content.

Tools

This server provides the following tools:

list_images
  • Description: List image files in a specified directory.
  • Parameters:
    • directoryPath (string): The absolute path to the directory to scan for images.
  • Returns: A list of image filenames found in the directory or a message indicating no images were found.
  • Supported Extensions: .jpg, .jpeg, .png, .gif, .bmp, .webp, .svg
read_image
  • Description: Reads a specific image file and returns its content as base64.
  • Parameters:
    • filePath (string): The absolute path to the image file to read.
  • Returns: An object containing the image content suitable for display (using imageContent helper from fastmcp).
  • Supported Extensions: .jpg, .jpeg, .png, .gif, .bmp, .webp, .svg
Setup

To configure an MCP client, add the imageReader entry to the mcpServers object. It should look something like this:

{
  "mcpServers": {
    // ... other servers might be here ...
    "imageReader": {
      "command": "npx",
      "args": ["image-reader-mcp"],
      "env": {}
    }
  }
}

Important Note: When using this server with Cursor, it currently seems to function only when Claude Sonnet is selected (other models don't seem to have vision enabled).

Comments

Markdown supported

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.