Image Reader MCP Server

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