Clover IIIF Viewer

What it does

Clover MCP wraps the Samvera Clover IIIF viewer into an MCP UI resource, letting AI clients render and interact with IIIF manifests and collections inline. Instead of receiving raw JSON metadata, users get a full visual viewer for digital collections, rare manuscripts, maps, and high-resolution imagery.

The package provides a CloverUIResource class that handles resource registration, tool wiring, and Content Security Policy configuration. You register tools that return IIIF manifest URLs, and the viewer automatically displays the content when results arrive.

Key features

• IIIF viewer as MCP UI resource — Renders IIIF manifests and collections with zoom, pan, and multi-canvas navigation.
• Configurable CSP domains — Control which origins are allowed for resource loading and API connections.
• Automatic tool wiring — registerTool() attaches your tool to the viewer resource in one call.
• Single-file HTML bundle — The viewer compiles to a self-contained HTML file for reliable rendering in any MCP client.
• Local stdio server included — A ready-to-run example server with a view_iiif_content tool for quick testing.

Installation

Install the package:

npm install @nulib/clover-mcp

For Claude Desktop, add the local server to your claude_desktop_config.json:

{
  "mcpServers": {
    "clover-local": {
      "command": "/path/to/clover-mcp/examples/local-server/bin/run.sh"
    }
  }
}

Set CLOVER_ALLOWED_ORIGINS to restrict which IIIF origins the viewer can load.

Supported hosts

Claude Desktop (confirmed in README with local server example).