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).