IIIF Images

Provides access to IIIF manifests and images with region extraction capabilities.

javascript

4

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mikeapp-mcp-iiif-images": {
      "command": "node",
      "args": [
        "/PATH/TO/mcp-iiif-images/server/server.js"
      ]
    }
  }
}

This MCP server lets you work with IIIF manifests and images by exposing a programmable interface that fetches manifests, retrieves images, and pulls specific image regions. It enables you to integrate IIIF content into your workflows, describe images, and describe text within images with structured MCP interactions.

How to use

You interact with this MCP server through an MCP client to fetch IIIF manifests, retrieve IIIF images, and request specific regions of an image for detailed analysis. Use the available tools to gather manifest data, load image data, and zoom into regions of interest for description and analysis.

How to install

Prerequisites you need before installing: Node.js installed on your system and npm available in your shell.

Step by step install and run the server locally:

# Install dependencies
npm install

# Start in stdio mode (default)
node server/server.js

# Start in HTTP streaming mode on port 3000
node server/server.js --http

Additional setup notes

If you plan to connect Claude Desktop or another MCP client, you may need to configure the client to start the server in the appropriate transport mode. The standard mode runs the server directly, while HTTP mode exposes an HTTP endpoint for message streaming.

Troubleshooting and notes

If you encounter issues with large IIIF manifests or large image data, be aware that the server scales content to dimensions that work with the intended client. Large manifests may cause processing delays or require chunked handling by your client.

Testing

To run tests locally you can use the project’s test commands. These verify functionality for manifest fetching, image retrieval, and region extraction.

# Run tests once
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm test -- --coverage

Supported tools

This MCP server provides the following tools for interacting with IIIF content.

• fetch_iiif_manifest — Fetches and validates a IIIF manifest from a URL.

• fetch_iiif_image — Retrieves a IIIF image given a base URI by fetching info.json and returning the image data.

• fetch_iiif_image_region — Retrieves a specific region of a IIIF image using percentage coordinates, scaled to fit within the same constraints.

Available tools

fetch_iiif_manifest

Fetches and validates a IIIF manifest from a URL.

fetch_iiif_image

Retrieves a IIIF image from a base URI by fetching info.json and returning the image data.

fetch_iiif_image_region

Retrieves a specific region of a IIIF image using percentage coordinates, scaled to fit within the same constraints.