MCP ExplorerExplorer

Image Reader Mcp

@moiri-gambonion 10 months ago
2 GPL-3.0
FreeCommunity
AI Systems
#cursor#fastmcp#llm#mcp#mcp-server
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.

Overview

What is Image Reader Mcp

image-reader-mcp is an MCP (Model Context Protocol) server built with FastMCP that provides tools for listing local image files and reading their content. It is designed for integration with LLM agents.

Use cases

Use cases include integrating with LLM agents for image recognition tasks, automating image content retrieval for applications, and facilitating image processing workflows in various software solutions.

How to use

To use image-reader-mcp, configure your MCP client by adding the ‘imageReader’ entry to the ‘mcpServers’ object in your configuration. Use the ‘list_images’ tool to list image files in a specified directory and the ‘read_image’ tool to read a specific image file’s content.

Key features

Key features include the ability to list image files in a specified directory and read specific image files, returning their content in base64 format. It supports various image formats such as .jpg, .jpeg, .png, .gif, .bmp, .webp, and .svg.

Where to use

image-reader-mcp can be used in fields that require image processing and analysis, such as artificial intelligence, machine learning, and digital asset management.

Content

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:

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers