Skip to content
Conduit

mcp server

image-reader-mcp

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.

moiri-gamboni/image-reader-mcpcommunitylistedunreviewednot running here yet
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Node.js 20 or newer
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "image-reader-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "image-reader-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 14, 2026

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).

↑↓ navigate openesc close