MCP.so
Sign In

Image Reader MCP Server

@moiri-gamboni

Repository

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

Basic information

Category

Media & Design

License

GPL-3.0

Runtime

node

Transports

stdio

Publisher

moiri-gamboni

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.

Comments

More Media & Design MCP servers

Spotify MCP

varunneal

MCP to connect your LLM with Spotify.

606

Video Editor MCP server

burningion

MCP Interface for Video Jungle

278

Game Asset Generator using MCP and Hugging Face Spaces

MubarakHAlketbi

An MCP server for creating 2D/3D game assets from text using Hugging Face AI models.

146

KiCAD MCP: AI-Assisted PCB Design

mixelpixx

KiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Language Models (LLMs) like Claude to directly interact with KiCAD for printed circuit board design.

1.5K

MCP Google Map Server

cablate

A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration with LLM processing capabilities.

374