image-reader-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@image-reader-mcp list images in /Users/me/screenshots"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
imageContenthelper fromfastmcp).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).
Available Tools
2 toolslist_imagesB
List image files in a specified directory.
Inputs: directoryPath (required).
read_imageA
Reads a specific image file and returns its content as base64.
Inputs: filePath (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
list_images and read_image are clearly distinct: one discovers images in a directory, the other retrieves the content of a specific image. There is no overlap or ambiguity between them.
Both tool names follow a verb_noun pattern (list_images, read_image), using snake_case consistently. The naming is predictable and easy to infer.
With only two tools, the server feels minimal, which is borderline for a tool set. However, for an image reader, listing and reading are the essential operations, so the count is appropriate for the narrow scope, but still falls into the 'thin' category.
The server's purpose is to read images, and it provides the two core operations: enumerating available images and reading a specific one. There are no obvious gaps for this use case; it covers the full lifecycle of reading (discover then retrieve).
Maintenance
Related MCP Connectors
Image processing over MCP: compress and split images, generate images and QR codes.
Manage files and folders directly from your workspace. Read and write files, list directories, cre…
MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.
Read and search folders on your own computer with explicit consent. Files are never uploaded.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides secure access to local files from specified directories. Enables listing files, reading contents, and configurable file size and extension filtering.1MIT
- AlicenseAqualityBmaintenanceProvides tools to encode files to Base64 strings and decode Base64 content back to files, supporting both text and binary formats.2Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables safe reading, listing, and text searching of local files within a specified base directory.-
- FlicenseAqualityDmaintenanceEnables LLM hosts like Claude Code or Codex CLI to inspect folder structures and read unstructured documents (PDF, PPTX, DOCX, SVG, and images) by returning raw text and images for the host to summarize or analyze.2-