Image Reader MCP Server logo

Image Reader MCP Server

by moiri-gamboni

The Image Reader MCP Server is a simple MCP server built with FastMCP that provides tools to list image files in a directory and read a specific image file's content. It allows MCP clients to access and display images.

View on GitHub

Last updated: N/A

What is Image Reader MCP Server?

This server is a FastMCP-based server that provides tools for listing and reading image files. It enables MCP clients to access image data from a specified directory.

How to use Image Reader MCP Server?

To use this server, configure an MCP client by adding the imageReader entry to the mcpServers object with the appropriate command, arguments, and environment settings. The server provides two tools: list_images to list image files in a directory and read_image to read the content of a specific image file.

Key features of Image Reader MCP Server

  • Lists image files in a specified directory

  • Reads image file content and returns it as base64

  • Supports common image file extensions (.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg)

  • Easy integration with MCP clients via configuration

Use cases of Image Reader MCP Server

  • Displaying images in a user interface

  • Processing image data within an MCP client

  • Dynamically loading images based on user input

  • Integrating image viewing capabilities into other applications

FAQ from Image Reader MCP Server

What image formats are supported?

The server supports .jpg, .jpeg, .png, .gif, .bmp, .webp, and .svg image formats.

How do I specify the directory to scan for images?

Use the directoryPath parameter in the list_images tool to specify the absolute path to the directory.

How do I get the content of a specific image?

Use the read_image tool with the filePath parameter set to the absolute path of the image file. The content will be returned as base64.

What is the imageContent helper?

The imageContent helper (from fastmcp) is used to properly format the base64 image content for display in the client application.

Why does this server only seem to work with Claude Sonnet in Cursor?

Currently, it appears that only the Claude Sonnet model in Cursor has vision enabled, which is required for processing the image data. Other models may not be able to handle the image content correctly.