home / mcp / image viewer mcp server

Image Viewer MCP Server

MCP server for displaying images from local filesystem directly in Claude conversations

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "itrimble-image-viewer-mcp": {
      "command": "node",
      "args": [
        "/Users/ian/image-viewer-mcp/dist/index.js"
      ]
    }
  }
}

You can display images from your local filesystem directly inside Claude conversations. This MCP server handles image rendering, provides metadata, and can recursively search directories to help you manage images without leaving your chat.

How to use

You interact with this MCP server through a client that supports MCPs. First, start the local server, then configure your client to connect to it. Once connected, you can display images, list image files in a directory, and fetch image information. Use the dedicated tools to perform these actions and rely on the returned data to render images inside Claude conversations.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

1) Install dependencies for the project.

npm install

2) Build the project.

npm run build

3) Add the MCP server configuration to your Claude MCP setup with the following JSON snippet.

{
  "mcpServers": {
    "image-viewer": {
      "command": "node",
      "args": ["/Users/ian/image-viewer-mcp/dist/index.js"]
    }
  }
}

Additional notes

This server supports displaying images, listing image files, and retrieving image metadata. Ensure the file paths you provide are readable by the process running the MCP server. Relative paths and ~ for home directory are supported in the tools.

Available tools

display-image

Display an image from the filesystem. Returns the image as base64 data that Claude can render.

list-images

Find and list image files in a directory. Supports recursive search if requested.

image-info

Get detailed information about an image file without loading the full image data.