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