Image Reader MCP Server
@moiri-gamboni
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.
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
imageContenthelper 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.
