Image Reader MCP Server
About
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.
Details
- Author
- moiri-gamboni
- GitHub stars
- 9
- Downloads
- 504
- Categories
- Media, AI
Jump to
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Image Reader MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"image reader mcp server": {
"imageReader": {
"command": "npx",
"args": [
"image-reader-mcp"
],
"env": []
}
}
}
}McpServers
{
"imageReader": {
"command": "npx",
"args": [
"image-reader-mcp"
],
"env": []
}
}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).
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
