Comprehensive support for the IIIF (International Image Interoperability Framework) protocol for searching, navigating, and working with digital collections from museums, libraries, and archives worldwide.

Installation

Standard Installation

npm install
npm run build

Single File Bundle

npm run bundle
# Creates iiif-mcp-bundle.js - npm install not needed for deployment

Configuration

Standard Installation

{
  "mcpServers": {
    "iiif": {
      "command": "node",
      "args": ["/path/to/mcp_iiif/dist/index.js"]
    }
  }
}

Single File Bundle

{
  "mcpServers": {
    "iiif": {
      "command": "node",
      "args": ["/path/to/iiif-mcp-bundle.js"]
    }
  }
}

Available Tools

Tool	Description
iiif-image-fetch	Retrieve actual IIIF image data with size constraints and region support
iiif-manifest-canvases	List all canvases in a manifest with filtering options
iiif-canvas-info	Get detailed information about specific canvases
iiif-search	Search within IIIF resources using the Content Search API
iiif-manifest	Retrieve manifest metadata from IIIF Presentation API
iiif-collection	Retrieve and navigate IIIF collections with hierarchical structure support
iiif-image	Build IIIF Image API URLs and retrieve image information
iiif-annotation	Extract and analyze annotations from IIIF resources, including text transcriptions, translations, and more

Features

• Full-text search within IIIF documents with support for Search API v0, v1, and v2
• Support for IIIF Presentation API v2 and v3 formats
• Image operations with region, size, rotation, quality, and format parameters
• Complete IIIF Authorization Flow API implementation with session management
• Audio/video content support with duration calculation and chapter navigation
• Collection management with hierarchical navigation through nested collections
• Annotation operations with multilingual support and filtering
• Change tracking through Change Discovery API with activity stream navigation
• Structured output support for integration with other MCP servers
• Single file packaging using esbuild for deployment without npm

Usage Examples

Search for 'Paris' in Harvard's IIIF collection

Fetch a cropped and resized image from an IIIF server

List all canvases in a manuscript with annotations

Get detailed information about a specific canvas including image dimensions

Navigate through a collection's hierarchical structure

Notes

The server has been tested with IIIF collections from NC State University and successfully deployed in Claude Desktop. All tools support structured output for better integration with other MCP servers and programmatic processing. Version 1.1.0 represents image data retrieval capabilities and enhanced canvas navigation.